匯入 XML 命名空間前置詞,以用於 XML 常值和 XML 軸屬性。
語法
Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">
組件
xmlNamespacePrefix
選擇性。 XML 元素和屬性可以參考的 xmlNamespaceName字串。
xmlNamespacePrefix如果未提供 ,則匯入的 XML 命名空間是預設的 XML 命名空間。 必須是有效的 XML 識別碼。 如需詳細資訊,請參閱 宣告的 XML 元素和屬性的名稱。
xmlNamespaceName
必須的。 識別要匯入之 XML 命名空間的字串。
備註
您可以使用 Imports 語句來定義全域 XML 命名空間,您可以搭配 XML 常值和 XML 軸屬性使用,或做為傳遞至 GetXmlNamespace 運算子的參數。 (如需使用 Imports 語句匯入可在程式碼中使用類型名稱的別名的詳細資訊,請參閱 Imports 語句 (.NET 命名空間和類型) 。 使用 Imports 語句宣告 XML 命名空間的語法與 XML 中使用的語法相同。 因此,您可以從 XML 檔案複製命名空間宣告,並在 語句中使用 Imports 它。
當您想要重複建立來自相同命名空間的 XML 元素時,XML 命名空間前置詞很有用。 以語句宣告的 Imports XML 命名空間前置詞是全域的,因為它可供檔案中的所有程式代碼使用。 當您建立 XML 元素常值,以及存取 XML 軸屬性時,可以使用它。 如需詳細資訊,請參閱 XML 元素常值 和 XML 軸屬性。
如果您定義不含命名空間前置詞的全域 XML 命名空間(例如 Imports <xmlns="http://SomeNameSpace>"),該命名空間會被視為預設 XML 命名空間。 預設 XML 命名空間用於未明確指定命名空間的任何 XML 專案常值或 XML 屬性軸屬性。 如果指定的命名空間是空的命名空間,也就是 , xmlns=""也會使用預設命名空間。 預設 XML 命名空間不適用於 XML 常值中的 XML 屬性或沒有命名空間的 XML 屬性座標軸屬性。
XML 常值中所定義的 XML 命名空間,稱為 本機 XML 命名空間,優先於語句定義為全域的 Imports XML 命名空間。 語句定義的 Imports XML 命名空間優先於針對 Visual Basic 項目匯入的 XML 命名空間。 如果 XML 常值定義 XML 命名空間,該本機命名空間不會套用至內嵌表達式。
全域 XML 命名空間遵循與 .NET Framework 命名空間相同的範圍和定義規則。 因此,您可以包含 Imports 語句來定義全域 XML 命名空間,您可以在匯入 .NET Framework 命名空間的任何位置。 這包括程式代碼檔案和專案層級匯入的命名空間。 如需專案層級匯入命名空間的詳細資訊,請參閱 參考頁面、專案設計工具 (Visual Basic) 。
每個來源檔案可以包含任意數目的 Imports 語句。 這些必須遵循選項宣告,例如 Option Strict 語句,而且它們必須在程式設計專案宣告之前,例如 Module 或 Class 語句。
範例 1
下列範例會匯入預設 XML 命名空間,以及以 前置 ns詞 識別的 XML 命名空間。 然後,它會建立使用這兩個命名空間的 XML 常值。
' Place Imports statements at the top of your program.
Imports <xmlns="http://DefaultNamespace">
Imports <xmlns:ns="http://NewNamespace">
Module Module1
Sub Main()
' Create element by using the default global XML namespace.
Dim inner = <innerElement/>
' Create element by using both the default global XML namespace
' and the namespace identified with the "ns" prefix.
Dim outer = <ns:outer>
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<%= inner %>
</ns:outer>
' Display element to see its final form.
Console.WriteLine(outer)
End Sub
End Module
此程式代碼會顯示下列文字:
<ns:outer xmlns="http://DefaultNamespace"
xmlns:ns="http://NewNamespace">
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<innerElement />
</ns:outer>
範例 2
下列範例會匯入 XML 命名空間前置詞 ns。 然後,它會建立 XML 常值,該常值會使用命名空間前置詞,並顯示元素的最終形式。
' Place Imports statements at the top of your program.
Imports <xmlns:ns="http://SomeNamespace">
Class TestClass1
Shared Sub TestPrefix()
' Create test using a global XML namespace prefix.
Dim inner2 = <ns:inner2/>
Dim test =
<ns:outer>
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1/>
<%= inner2 %>
</ns:middle>
</ns:outer>
' Display test to see its final form.
Console.WriteLine(test)
End Sub
End Class
此程式代碼會顯示下列文字:
<ns:outer xmlns:ns="http://SomeNamespace">
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1 />
<inner2 xmlns="http://SomeNamespace" />
</ns:middle>
</ns:outer>
請注意,編譯程式已將 XML 命名空間前置詞從全域前置詞轉換成本機前置詞定義。
範例 3
下列範例會匯入 XML 命名空間前置詞 ns。 然後,它會使用命名空間的前置詞來建立 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