XmlNamespaceManager.AddNamespace(String, String) 方法

  • 參考

定義

命名空間:
System.Xml
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll

將指定的命名空間加入集合中。

public:
 virtual void AddNamespace(System::String ^ prefix, System::String ^ uri);
public virtual void AddNamespace (string prefix, string uri);
abstract member AddNamespace : string * string -> unit
override this.AddNamespace : string * string -> unit
Public Overridable Sub AddNamespace (prefix As String, uri As String)

參數

prefix
String

與要加入的命名空間關聯的前置詞。 使用 String.Empty 來加入預設命名空間。

注意 若 XmlNamespaceManager 將用於解析 XML 路徑語言 (XPath) 運算式中的命名空間，則必須指定前置詞。 如果 XPath 運算式不包括前置詞，則會假設命名空間統一資源識別項 (URI) 為空命名空間。 如需有關 XPath 運算式以及 XmlNamespaceManager 的詳細資訊，請參考 SelectNodes(String) 和 SetContext(XmlNamespaceManager) 方法。

uri
String

要加入的命名空間。

例外狀況

ArgumentException

prefix 的值為 "xml" 或 "xmlns"。

ArgumentNullException

prefix 或 uri 的值為 null。

範例

下列範例會使用 XmlNamespaceManager 來解析 XML 片段中的命名空間。

using System;
using System.Xml;

public class Sample
{

    public static void Main()
    {

        XmlTextReader reader = null;

        try
        {

            // Create the string containing the XML to read.
            String xmlFrag = "<book>" +
                           "<title>Pride And Prejudice</title>" +
                           "<author>" +
                           "<first-name>Jane</first-name>" +
                           "<last-name>Austen</last-name>" +
                           "</author>" +
                           "<curr:price>19.95</curr:price>" +
                           "<misc>&h;</misc>" +
                           "</book>";

            // Create an XmlNamespaceManager to resolve namespaces.
            NameTable nt = new NameTable();
            XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
            nsmgr.AddNamespace(String.Empty, "urn:samples"); //default namespace
            nsmgr.AddNamespace("curr", "urn:samples:dollar");

            // Create an XmlParserContext.  The XmlParserContext contains all the information
            // required to parse the XML fragment, including the entity information and the
            // XmlNamespaceManager to use for namespace resolution.
            XmlParserContext context;
            String subset = "<!ENTITY h 'hardcover'>";
            context = new XmlParserContext(nt, nsmgr, "book", null, null, subset, null, null, XmlSpace.None);

            // Create the reader.
            reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context);

            // Parse the file and display the node values.
            while (reader.Read())
            {
                if (reader.HasValue)
                    Console.WriteLine("{0} [{1}] = {2}", reader.NodeType, reader.Name, reader.Value);
                else
                    Console.WriteLine("{0} [{1}]", reader.NodeType, reader.Name);
            }
        }
        finally
        {
            if (reader != null)
                reader.Close();
        }
    }
} // End class

Imports System.Xml

Public Class Sample

    Public Shared Sub Main()

        Dim reader As XmlTextReader = Nothing

        Try

            ' Create the string containing the XML to read.
            Dim xmlFrag As String
            xmlFrag = "<book>" & _
                           "<title>Pride And Prejudice</title>" & _
                           "<author>" & _
                           "<first-name>Jane</first-name>" & _
                           "<last-name>Austen</last-name>" & _
                           "</author>" & _
                           "<curr:price>19.95</curr:price>" & _
                           "<misc>&h;</misc>" & _
                           "</book>"

            ' Create an XmlNamespaceManager to resolve namespaces.
            Dim nt As NameTable = New NameTable()
            Dim nsmgr As XmlNamespaceManager = New XmlNamespaceManager(nt)
            nsmgr.AddNamespace(String.Empty, "urn:samples") 'default namespace
            nsmgr.AddNamespace("curr", "urn:samples:dollar")

            ' Create an XmlParserContext.  The XmlParserContext contains all the information
            ' required to parse the XML fragment, including the entity information and the
            ' XmlNamespaceManager to use for namespace resolution.
            Dim context As XmlParserContext
            Dim subset As String = "<!ENTITY h 'hardcover'>"
            context = New XmlParserContext(nt, nsmgr, "book", Nothing, Nothing, subset, Nothing, Nothing, XmlSpace.None)

            ' Create the reader.
            reader = New XmlTextReader(xmlFrag, XmlNodeType.Element, context)

            ' Parse the file and display the node values.
            While (reader.Read())
                If (reader.HasValue) Then
                    Console.WriteLine("{0} [{1}] = {2}", reader.NodeType, reader.Name, reader.Value)
                Else
                    Console.WriteLine("{0} [{1}]", reader.NodeType, reader.Name)
                End If
            End While

        Finally
            If Not (reader Is Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub
End Class

備註

XmlNamespaceManager 不會檢查 prefix 和 uri 是否有一致性。

XmlReader 會檢查名稱，包括前置詞和命名空間，以確保它們根據 World Wide Web Consortium (W3C) Namespaces 規格有效 XML 名稱。 XmlNamespaceManager 會由 XmlReader 內部使用，因此為了避免重複工作， XmlNamespaceManager 假設所有前置詞和命名空間都有效。

如果前置詞和命名空間已存在於目前範圍內，新的前置詞和命名空間組將會取代現有的前置詞/命名空間組合。 不同的範圍可以存在相同的前置詞和命名空間組合。

預設會將下列前置詞/命名空間組新增至 XmlNamespaceManager 。 它們可以在任何範圍中判斷。

前置詞 命名空間
xmlns http://www.w3.org/2000/xmlns/ (xmlns 前置詞命名空間)
Xml http://www.w3.org/XML/1998/namespace (XML 命名空間)
String.Empty String.Empty (空命名空間) 。 此值可以重新指派不同的前置詞。 例如，xmlns=「」 會將預設命名空間定義為空的命名空間

適用於

另請參閱