XPathResultType

XPathResultType enumeration

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

public enum XPathResultType

قيم

اسمقيمةوصف
Any0لا يمثل هذا الرمز نوعًا محددًا. لن ينتج عن تقييم تعبير XPath هذا النوع أبدًا. إذا تم طلب هذا النوع ، فسيقوم التقييم بإرجاع أي نوع ينتج بشكل طبيعي من تقييم التعبير. إذا كانت النتيجة الطبيعية عبارة عن مجموعة عقدة عندأي تم طلب النوع ، إذنUnorderedNodeIterator هو دائمًا النوع الناتج. يجب أن يكون أي تمثيل آخر لمجموعة العقدة مطلوبًا بشكل صريح .
Number1النتيجة هي رقم كما تم تعريفه بواسطة [XPath 1.0]. لا يؤدي تعديل المستند إلى إلغاء صلاحية الرقم ، ولكن قد يعني أن إعادة التقييم لن ينتج عنه نفس الرقم.
String2النتيجة عبارة عن سلسلة كما تم تعريفها بواسطة [XPath 1.0]. لا يؤدي تعديل المستند إلى إبطال السلسلة ، ولكن قد يعني أن السلسلة لم تعد تتوافق مع المستند الحالي.
Boolean3النتيجة منطقية كما تم تعريفها بواسطة [XPath 1.0]. لا يؤدي تعديل المستند إلى إبطال المنطقية ، ولكن قد يعني أن إعادة التقييم لن تؤدي إلى نفس القيمة المنطقية.
UnorderedNodeIterator4النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها بشكل تكراري ، والتي قد لا تنتج عقدًا بترتيب معين. يؤدي تعديل المستند إلى إبطال التكرار . هذا هو النوع الافتراضي الذي يتم إرجاعه إذا كانت النتيجة مجموعة عقدة وأي مطلوب نوع .
OrderedNodeIterator5النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها بشكل تكراري ، والتي ستنتج عقدًا مرتبة حسب المستندات. تعديل المستند يبطل التكرار.
UnorderedNodeSnapshot6والنتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها كقائمة من العقد التي قد لا تكون بترتيب معين. لا يؤدي تعديل المستند إلى إبطال اللقطة ولكنه قد يعني أن إعادة التقييم لن تؤدي إلى نفس اللقطة وقد يتم تغيير العقد الموجودة في اللقطة أو نقلها أو إزالتها من المستند.
OrderedNodeSnapshot7النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] والتي سيتم الوصول إليها كقائمة من العقد التي ستكون بترتيب المستند الأصلي. لا يؤدي تعديل المستند إلى إبطال اللقطة ولكنه قد يعني أن إعادة التقييم لن تؤدي إلى نفس اللقطة وقد يتم تغيير العقد الموجودة في اللقطة أو نقلها أو إزالتها من المستند.
AnyUnorderedNode8النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] وسيتم الوصول إليها كعقدة واحدة ، والتي قد تكونلا شيءإذا كانت مجموعة العقدة فارغة. لا يؤدي تعديل المستند إلى إبطال العقدة ، ولكن قد يعني أن العقدة الناتجة لم تعد تتوافق مع المستند الحالي. هذه هي الراحة التي تسمح بالتحسين حيث يمكن أن يتوقف التنفيذ بمجرد العثور على أي عقدة في المجموعة الناتجة. إذا كان هناك أكثر من عقدة في النتيجة الفعلية ، فقد لا تكون العقدة المفردة التي تم إرجاعها هي الأولى في ترتيب المستندات.
FirstOrderedNode9النتيجة هي مجموعة عقدة على النحو المحدد بواسطة [XPath 1.0] وسيتم الوصول إليها كعقدة واحدة ، والتي قد تكونلا شيءإذا كانت مجموعة العقدة فارغة. لا يؤدي تعديل المستند إلى إبطال العقدة ، ولكن قد يعني أن العقدة الناتجة لم تعد تتوافق مع المستند الحالي. هذه هي الراحة التي تسمح بالتحسين حيث يمكن أن يتوقف التنفيذ بمجرد العثور على العقدة الأولى بترتيب المستندات للمجموعة الناتجة. إذا كان هناك أكثر من عقدة في النتيجة الفعلية ، فستكون العقدة المفردة التي تم إرجاعها هي الأولى في ترتيب المستند.

أنظر أيضا