مشاركة عبر

الـقيمة ألحرفية لعنصر XML

  • مقالة

قيمة حرفية التي تمثل XElement الكائن.

<name [ attributeList ] />
-or-
<name [ attributeList ] > [ elementContents ] </[ name ]>

الأجزاء

  • <
    مطلوبة. يـفتح علامة عنصر البداية.

  • name
    مطلوبة. اسم العنصر التنسيق هو عبارة عن أي من الحالات التالية:

    • نص قيمة حرفية لاسم العنصر على الشكل (ePrefix:)eName، حيث:

      جزء

      الوصف

      ePrefix

      اختياري. بادئة مساحة الاسم XML للعنصر. يجب أن يكون مساحة اسم XML عام المعرف باستخدام كشف Imports في الملف أو على مستوى المشروع, أو مساحة اسم XML محلية التي يتم تعريفها في هذا العنصر أو عنصر الأصلي.

      eName

      مطلوبة. اسم العنصر التنسيق هو عبارة عن أي من الحالات التالية:

    • الـتعبير المضمن على شكل <%=nameExp%>. نوع الـ nameExp يجب أن يكون String أو نوع يمكن تحويله ضمنيًا إلى XName. التعبير المضمن لا يسمح به في علامة إغلاق لعنصر .

  • attributeList
    اختياري. قائمة السمات المعرفة في قيمة حرفية.

    attribute [ attribute ... ]

    كلattribute يحتوي إحدى بُنى جمل التالية:

    • تعيين سمة, على الشكل (aPrefix:)aName=aValue، حيث:

      جزء

      الوصف

      aPrefix

      اختياري. بادئة مساحة الاسم XML للسمة. يجب أن يكون مساحة اسم XML عمومية التي يتم تعريفها مع Imports الكشف, أو مساحة اسم XML محلية الذي يتم تعريفه في هذا العنصر أو عنصر أصل.

      aName

      مطلوبة. اسم السمة. التنسيق هو عبارة عن أي من الحالات التالية:

      aValue

      اختياري. قيمة السمة. التنسيق هو عبارة عن أي من الحالات التالية:

      • نص القيمة الحرفية, محاطة بعلامات اقتباس.

      • الـتعبير المضمن على شكل <%=aValueExp%>. يتم السماح بأي نوع.

    • الـتعبير المضمن على شكل <%=aExp%>.

  • />
    اختياري. يشير إلى أن العنصر هو عنصر فارغ, بدون محتوى.

  • >
    مطلوبة. ينهي علامة عنصر البداية أو الفارغ.

  • elementContents
    اختياري. محتوى العنصر.

    content [ content ... ]

    كل content يمكن أن يكون واحد مما يلي:

  • </[name]>
    اختياري. تمثل علامة إغلاق للعنصر. الـمعلمة الاختياريةname غير مسموح بها عندما تكون نتيجة التعبير المضمنة.

القيمة المُرجعة

كائن XElement .

ملاحظات

يمكنك استخدام بناء جملة القيمة الحرفية لعنصر XML لإنشاء XElement الكائنات في التعليمات البرمجية.

ملاحظة

أن تمتد XML قيمة حرفية لأسطر متعددة بدون استخدام حرف متابعة السطر. يتيح لك ذلك إلى نسخ محتوى من مستند XML و لصقه مباشرة في برنامج Visual Basic.

الـتعبيرات المضمنة على الشكل <%=exp%> تمكنك من إضافة معلومات ديناميكية إلى القيمة الحرفية لعنصر XML . لمزيد من المعلومات، راجع التعبيرات المضمنة في XML.

برنامج التحويل البرمجي Visual Basic يحول القيمة الحرفية لعنصر XML الى استدعاءات لـ في XElement المُنشئ و إذا كانت مطلوبة، XAttribute المنشئ.

مساحة أسماء XML،

بادئات مساحة اسم XML مفيدة عندما تحتاج إلى إنشاء القيم الحرفية XML مع عناصر من مساحة الاسم نفسه عدة مرات في التعليمات البرمجية. يمكنك استخدام بادئات مساحات الأسماء XML العمومية, التي تعرفها باستخدام Imports الكشف, أو بادئات محلية, التى تعرفها باستخدام xmlns:xmlPrefix="xmlNamespace"بناء جملة سمة. لمزيد من المعلومات، راجع استيراد كشف (مساحة الاسم و نوع NET.).

التنظيم مع قواعد المجال لمساحات الاسم XML, البادئات المحلية لها الأسبقية على البادئات العمومية. ومع ذلك، إذا كان القيمة الحرفية XML تعرّف مساحة اسم XML, لا يتوفر مساحة الاسم ذلك للتعبيرات التي تظهر في التعبير المضمنة. يمكن للتعبير المضمنة الوصول فقط إلى مساحة الاسم XML العمومية .

برنامج التحويل البرمجي Visual Basic يحول كل مساحة اسم XML العمومية المستخدمة من قبل القيمة الحرفية XML الى تعريف مساحة اسم محلي واحد في التعليمات البرمجية المنشأة. لا تظهر مساحات الاسم XML العمومية الغير مستخدمة في التعليمات البرمجية المنشأة.

مثال

يظهر المثال التالي كيفية إنشاء عنصر XML بسيط الذي يحتوي على عنصرين اثنين متداخلين فارغين.

Dim test1 As XElement = 
<outer>
    <inner1></inner1>
    <inner2/>
</outer>

Console.WriteLine(test1)

يعرض المثال النص التالي. لاحظ أن القيمة الحرفية تحتفظ بالبنية للعناصر الفارغة.

<outer>
  <inner1></inner1>
  <inner2 />
</outer>

يظهر المثال التالي كيفية استخدام التعبيرات المضمنة لتسمية عنصر و إنشاء سمات.

Dim elementType = "book"
Dim authorName = "My Author"
Dim attributeName1 = "year"
Dim attributeValue1 = 1999
Dim attributeName2 = "title"
Dim attributeValue2 = "My Book"

Dim book As XElement = 
<<%= elementType %>
    isbn="1234"
    author=<%= authorName %>
    <%= attributeName1 %>=<%= attributeValue1 %>
    <%= New XAttribute(attributeName2, attributeValue2) %>
/>

Console.WriteLine(book)

هذه التعليمات البرمجية يعرض نص التالي:

<book isbn="1234" author="My Author" year="1999" title="My Book" />

يقوم المثال التالي بتعريف ns كبادئة مساحة الاسم XML. ثم يقوم بإستخدام بادئة مساحة الاسم لانشاء قيمة حرفية XML ويعرض شكل العنصر النهائي.

' Place Imports statements at the top of your program.  
Imports <xmlns:ns="http://SomeNamespace">

Class TestClass1

    Shared Sub TestPrefix()
        ' Create test using a global XML namespace prefix. 
        Dim inner2 = <ns:inner2/>

        Dim test = 
        <ns:outer>
            <ns:middle xmlns:ns="http://NewNamespace">
                <ns:inner1/>
                <%= inner2 %>
            </ns:middle>
        </ns:outer>

        ' Display test to see its final form. 
        Console.WriteLine(test)
    End Sub

End Class

هذه التعليمات البرمجية يعرض نص التالي:

<ns:outer xmlns:ns="http://SomeNamespace">
  <ns:middle xmlns:ns="http://NewNamespace">
    <ns:inner1 />
    <inner2 xmlns="http://SomeNamespace" />
  </ns:middle>
</ns:outer>

لاحظ أن المحول البرمجي يحول بادئة مساحة اسم XML العمومية الى تعريف بادئة لمساحة اسم XML. عنصر <ns:middle> يعيد تعريف بادئة مساحة اسم XML لعنصر <ns:inner1>. على الرغم من ذلك، يستخدم عنصر <ns:inner2> مساحة الاسم المعرّفة بواسطةImports الكشف.

راجع أيضًا:

المرجع

XElement

تعليق حرفي XML

الـقيمة الحرفية CDATA XML

استيراد كشف (مساحة الاسم و نوع NET.)

المبادئ

أسماء عناصر XML المُعلَنة و السمات

التعبيرات المضمنة في XML

موارد أخرى

حرفي XML

إنشاء XML في Visual Basic