共用方式為


XML 子系座標軸屬性 (Visual Basic)

提供下列子系的存取權: XElement 物件、 XDocument 物件、物件的集合 XElement 或 物件的集合 XDocument

語法

object...<descendant>

組件

object 必填。 XElement物件、XDocument物件、物件的集合XElement或物件的集合XDocument

...< 必填。 表示子系座標軸屬性的開頭。

descendant 必填。 要存取之子系節點的名稱,格式為 [prefix:]name

部分 說明
prefix 選擇性。 子代節點的 XML 命名空間前置詞。 必須是使用 Imports 語句定義的全域 XML 命名空間。
name 必須的。 子代節點的本機名稱。 請參閱 宣告的 XML 專案和屬性的名稱

> 必填。 表示子系座標軸屬性的結尾。

傳回值

物件的 XElement 集合。

備註

您可以使用 XML 子系座標軸屬性,依名稱從 XElementXDocument 物件,或從 或 XDocument 物件的集合XElement存取子系節點。 使用 XML Value 屬性來存取傳回集合中第一個子代節點的值。 如需詳細資訊,請參閱 XML Value 屬性

Visual Basic 編譯程式會將子系座標軸屬性轉換成對 方法的 Descendants 呼叫。

XML 命名空間

子系座標軸屬性中的名稱只能搭配 語句使用全域宣告的 Imports XML 命名空間。 它無法使用在 XML 專案常值內本機宣告的 XML 命名空間。 如需詳細資訊,請參閱 Imports 陳述式(XML 命名空間)

範例 1

下列範例示範如何存取名為 name 的第一個子代節點的值,以及從 contacts 物件命名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

範例 2

下列範例會將 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

另請參閱