XPathResultType

XPathResultType enumeration

اختصار بدون إشارة يشير إلى نوع هذه النتيجة. إذا كان محددًايكتبتم تحديده ، ثم سيتم إرجاع النتيجة كنوع المقابل ، باستخدام تحويلات نوع XPath حيثما كان ذلك مطلوبًا وممكنًا.

public enum XPathResultType

قيم

اسم قيمة وصف
Any 0 لا يمثل هذا الرمز نوعًا محددًا. لن ينتج عن تقييم تعبير XPath هذا النوع أبدًا. إذا تم طلب هذا النوع ، فسيقوم التقييم بإرجاع أي نوع ينتج بشكل طبيعي من تقييم التعبير. إذا كانت النتيجة الطبيعية عبارة عن مجموعة عقدة عندأي تم طلب النوع ، إذنUnorderedNodeIterator هو دائمًا النوع الناتج. يجب أن يكون أي تمثيل آخر لمجموعة العقدة مطلوبًا بشكل صريح .
Number 1 النتيجة هي رقم كما تم تعريفه بواسطة [XPath 1.0]. لا يؤدي تعديل المستند إلى إلغاء صلاحية الرقم ، ولكنه قد يعني أن إعادة التقييم لن ينتج عنه نفس الرقم.
String 2 النتيجة عبارة عن سلسلة كما تم تعريفها بواسطة [XPath 1.0]. لا يؤدي تعديل المستند إلى إبطال السلسلة ، ولكن قد يعني أن السلسلة لم تعد تتوافق مع المستند الحالي.
Boolean 3 النتيجة منطقية كما تم تعريفها بواسطة [XPath 1.0]. لا يؤدي تعديل المستند إلى إبطال المنطقية ، ولكنه قد يعني أن إعادة التقييم لن ينتج عنه نفس القيمة المنطقية.
UnorderedNodeIterator 4 النتيجة هي مجموعة عقدة كما تم تعريفها بواسطة [XPath 1.0] والتي سيتم الوصول إليها بشكل تكراري ، والتي قد لا تنتج عقدًا بترتيب معين. يؤدي تعديل المستند إلى إبطال التكرار . هذا هو النوع الافتراضي الذي يتم إرجاعه إذا كانت النتيجة مجموعة عقدة وأي مطلوب النوع .
OrderedNodeIterator 5 النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها بشكل تكراري ، والتي ستنتج عقدًا مرتبة حسب المستندات. تعديل المستند يبطل التكرار.
UnorderedNodeSnapshot 6 والنتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها كقائمة من العقد التي قد لا تكون بترتيب معين. لا يؤدي تعديل المستند إلى إبطال اللقطة ولكنه قد يعني أن إعادة التقييم لن تؤدي إلى نفس اللقطة وقد يتم تغيير العقد الموجودة في اللقطة أو نقلها أو إزالتها من المستند.
OrderedNodeSnapshot 7 والنتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها كقائمة من العقد التي ستكون بترتيب المستند الأصلي. لا يؤدي تعديل المستند إلى إبطال اللقطة ولكنه قد يعني أن إعادة التقييم لن تؤدي إلى نفس اللقطة وقد يتم تغيير العقد الموجودة في اللقطة أو نقلها أو إزالتها من المستند.
AnyUnorderedNode 8 النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] وسيتم الوصول إليها كعقدة واحدة ، والتي قد تكونلا شيءإذا كانت مجموعة العقدة فارغة. لا يؤدي تعديل المستند إلى إبطال العقدة ، ولكن قد يعني أن العقدة الناتجة لم تعد تتوافق مع المستند الحالي. هذه هي الراحة التي تسمح بالتحسين حيث يمكن أن يتوقف التنفيذ بمجرد العثور على أي عقدة في المجموعة الناتجة. إذا كان هناك أكثر من عقدة في النتيجة الفعلية ، فقد لا تكون العقدة المفردة التي تم إرجاعها هي الأولى في ترتيب المستندات.
FirstOrderedNode 9 النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] وسيتم الوصول إليها كعقدة واحدة ، والتي قد تكونلا شيءإذا كانت مجموعة العقدة فارغة. لا يؤدي تعديل المستند إلى إبطال العقدة ، ولكن قد يعني أن العقدة الناتجة لم تعد تتوافق مع المستند الحالي. هذه هي الراحة التي تسمح بالتحسين حيث يمكن أن يتوقف التنفيذ بمجرد العثور على العقدة الأولى بترتيب المستندات للمجموعة الناتجة. إذا كان هناك أكثر من عقدة في النتيجة الفعلية ، فستكون العقدة المفردة التي تم إرجاعها هي الأولى في ترتيب المستند.

أنظر أيضا