共用方式為

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 子系軸屬性，從 XElement 或 XDocument 物件，或從 XElement 或 XDocument 物件集合，依據名稱存取子系節點。 使用 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

另請參閱