共用方式為


XML 子代軸屬性 (Visual Basic)

提供存取下列其中一項的子系:XElement 物件、XDocument 物件、XElement 物件的集合,或 XDocument 物件的集合。

object.<child>

組件

詞彙

定義

object

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

.<

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

child

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

參數說明
prefix 選擇項。子節點的 XML 命名空間前置字元。必須是使用 Imports 陳述式定義的全域 XML 命名空間。
name 必要項。區域子節點名稱。請參閱宣告的 XML 項目和屬性的名稱 (Visual Basic)

>

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

傳回值

XElement 物件的集合。

備註

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

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

XML 命名空間

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

範例

下列範例顯示如何存取 contact 集合中名為 phone 的子節點。

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

Dim homePhone = From hp In contact.<phone> 
                Where contact.<phone>.@type = "home" 
                Select hp

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

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

Home Phone = 206-555-0144

下列範例顯示如何從由 contacts 物件的 contact 子項軸屬性所傳回的集合中,存取名為 phone 的子節點。

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

Dim homePhone = From contact In contacts.<contact> 
                Where contact.<phone>.@type = "home" 
                Select contact.<phone>

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

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

Home Phone = 206-555-0144

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

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

Class TestClass4

    Shared Sub TestPrefix()
        Dim contact = <ns:contact>
                        <ns:name>Patrick Hines</ns:name>
                      </ns:contact>
        Console.WriteLine(contact.<ns:name>.Value)
    End Sub

End Class

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

Patrick Hines

請參閱

參考

XElement

概念

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

其他資源

XML 軸屬性 (Visual Basic)

XML 常值 (Visual Basic)

在 Visual Basic 中建立 XML