XML 屬性軸屬性
更新:2007 年 11 月
提供存取 XElement 物件中,或 XElement 物件的集合內第一個項目中的屬性 (Attribute) 值。
object.@attribute
-or-
object.@<attribute>
參數
.@
必要項。代表屬性 (Attribute) 軸屬性 (Property) 的開始。<
選擇項,當 attribute 在 Visual Basic 中不是有效的識別項時,代表屬性 (Attribute) 名稱的開始。attribute
必要項。要存取的屬性 (Attribute) 名稱,格式為 [prefix:]name。參數
說明
prefix
選擇項,屬性 (Attribute) 的 XML 命名空間前置字元必須是使用 Imports 陳述式定義的全域 XML 命名空間。
name
必要項。區域屬性 (Attribute) 名稱。請參閱宣告的 XML 項目和屬性的名稱。
>
選擇項,當 attribute 在 Visual Basic 中不是有效的識別項時,代表屬性 (Attribute) 名稱的結尾。
傳回值
字串,包含屬性 (Attribute) 的值。
備註
您可以使用 XML 屬性 (Attribute) 軸屬性 (Property) 依名稱存取 XElement 物件中或 XElement 物件的集合內第一個項目中的屬性 (Attribute) 值。.您可以依名稱擷取屬性 (Attribute) 值,或者藉由指定前有 @ 識別項的新名稱,將新的屬性 (Attribute) 加入至項目。
當您使用 @ 識別項參考 XML 屬性 (Attribute) 時,屬性 (Attribute) 值會以字串傳回,您不需要明確指定 Value 屬性 (Property)。
XML 屬性 (Attribute) 的命名規則與 Visual Basic 識別項的命名規則不同。如果要存取的 XML 屬性 (Attribute) 名稱不是有效的 Visual Basic 識別項,請以角括弧 (< 和 >) 括住該名稱。
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>
<type>home</type>
<type>work</type>
</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