共用方式為


XML 子代軸屬性 (Visual Basic)

提供存取下列項目的子代 (Descendant):XElement 物件、XDocument 物件、XElement 物件的集合,或 XDocument 物件的集合。

object...<descendant>

參數

  • object
    必要項。 XElement 物件、XDocument 物件、XElement 物件的集合,或 XDocument 物件的集合。

  • ...<
    必要項。 代表子代軸屬性的開始。

  • descendant
    必要項。 要存取的子代節點名稱,格式為 [prefix:]name。

    參數

    描述

    prefix

    選擇項。 子代節點的 XML 命名空間前置字元。 必須是使用 Imports 陳述式 (Statement) 定義的全域 XML 命名空間。

    name

    必要項。 子代節點的區域名稱。 請參閱宣告的 XML 項目和屬性的名稱 (Visual Basic)

  • >
    必要項。 代表子代軸屬性的結尾。

傳回值

XElement 物件的集合。

備註

您可以使用 XML 子代軸屬性,從 XElementXDocument 物件中,或是從 XElementXDocument 物件的集合中,依名稱存取子代節點。 使用 XML Value 屬性可以存取所傳回集合中第一個子代節點的值。 如需詳細資訊,請參閱 XML Value 屬性 (Visual Basic)

Visual Basic 編譯器會將子代軸屬性轉換為對 Descendants 方法的呼叫。

XML 命名空間

子代軸屬性中的名稱只能使用以 Imports 陳述式在全域宣告的 XML 命名空間, 不能使用在 XML 項目常值 (Literal) 內宣告的區域 XML 命名空間。 如需詳細資訊,請參閱 Imports 陳述式 (XML 命名空間)

範例

下列範例顯示如何從 contacts 物件存取名為 name 之第一個子代節點的值,以及名為 phone 之所有子代節點的值。

Dim contacts As XElement = 
    <contacts>
        <contact>
            <name>Patrick Hines</name>
            <phone type="home">206-555-0144</phone>
            <phone type="work">425-555-0145</phone>
        </contact>
    </contacts>

Console.WriteLine("Name: " & contacts...<name>.Value)

Dim homePhone = From phone In contacts...<phone> 
                Select phone.Value

Console.WriteLine("Home Phone = {0}", homePhone(0))

這個程式碼會顯示下列文字:

Name: Patrick Hines

Home Phone = 206-555-0144

下列範例將 ns 宣告為 XML 命名空間前置字元。 然後使用這個命名空間前置字元建立 XML 常值,並以限定名稱 ns:name 存取第一個子節點的值。

Imports <xmlns:ns = "http://SomeNamespace"> 

Class TestClass2

    Shared Sub TestPrefix()
        Dim contacts = 
            <ns:contacts>
                <ns:contact>
                    <ns:name>Patrick Hines</ns:name>
                </ns:contact>
            </ns:contacts>

        Console.WriteLine("Name: " & contacts...<ns:name>.Value)
    End Sub

End Class

這個程式碼會顯示下列文字:

Name: Patrick Hines

請參閱

參考

XElement

概念

宣告的 XML 項目和屬性的名稱 (Visual Basic)

其他資源

XML 軸屬性 (Visual Basic)

XML 常值 (Visual Basic)

在 Visual Basic 中建立 XML