XML 屬性軸屬性 (Visual Basic)

發行項
06/08/2015

提供存取 XElement 物件中屬性的值，或 XElement 物件集合內第一個項目的屬性值。

object.@attribute
-or-
object.@<attribute>

組件

object
必要項。 XElement 物件或 XElement 物件的集合。
.@
必要項。代表屬性 (Attribute) 軸屬性 (Property) 的開始。
<
選擇項。當 attribute 在 Visual Basic 中不是有效的識別項時，代表屬性 (Attribute) 名稱的開始。

attribute
必要項。要存取的屬性 (Attribute) 名稱，格式為 [prefix:]name。

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

>
選擇項。當 attribute 在 Visual Basic 中不是有效的識別項時，代表屬性 (Attribute) 名稱的結尾。

傳回值

字串，含有 attribute 的值。如果沒有屬性名稱，則會傳回 Nothing。

備註

您可以使用 XML 屬性 (Attribute) 軸屬性 (Property)，依名稱存取 XElement 物件中或 XElement 物件的集合內第一個項目中的屬性 (Attribute) 值。您可以依名稱擷取屬性 (Attribute) 值，或者藉由指定前有 @ 識別項的新名稱，將新的屬性 (Attribute) 加入至項目。

當您使用 @ 識別項參考 XML 屬性 (Attribute) 時，屬性 (Attribute) 值會以字串傳回，您不需要明確指定 Value 屬性 (Property)。

XML 屬性的命名規則與 Visual Basic 識別項的命名規則不同。若要存取其名稱並非有效 Visual Basic 識別項的 XML 屬性，請將名稱置於角括弧 (< 和 >) 之內。

XML 命名空間

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

範例

下列範例顯示如何從名為 phone 的 XML 項目集合中，取得名為 type 之 XML 屬性 (Attribute) 的值。

' Topic: XML Attribute Axis Property 
Dim phones As XElement = 
    <phones>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </phones>

Dim phoneTypes As XElement = 
  <phoneTypes>
      <%= From phone In phones.<phone> 
          Select <type><%= phone.@type %></type> 
      %>
  </phoneTypes>

Console.WriteLine(phoneTypes)

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

</phoneTypes>

下列範例顯示兩種為 XML 項目建立屬性 (Attribute) 的方法，一種是在 XML 中以宣告方式建立，一種是以動態方式將屬性 (Attribute) 加入至 XElement 物件的執行個體 (Instance)。 type 屬性 (Attribute) 是以宣告方式建立，而 owner 屬性 (Attribute) 是以動態方式建立。

Dim phone2 As XElement = <phone type="home">206-555-0144</phone>
phone2.@owner = "Harris, Phyllis"

Console.WriteLine(phone2)

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

<phone type="home" owner="Harris, Phyllis">206-555-0144</phone>

下列範例會使用角括弧語法取得名為 number-type 之 XML 屬性 (Attribute) 的值，這個名稱在 Visual Basic 中不是有效的識別項。

Dim phone As XElement = 
     <phone number-type=" work">425-555-0145</phone>

 Console.WriteLine("Phone type: " & phone.@<number-type>)

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

Phone type: work

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

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

Class TestClass3

    Shared Sub TestPrefix()
        Dim phone = 
            <ns:phone ns:type="home">206-555-0144</ns:phone>

        Console.WriteLine("Phone type: " & phone.@ns:type)
    End Sub 

End Class

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

Phone type: home

請參閱

共用方式為

XML 屬性軸屬性 (Visual Basic)

組件

傳回值

備註

XML 命名空間

範例

請參閱

參考

概念

其他資源

其他資源