XmlNamespaceManager.AddNamespace(String, String) 方法

参考

定义

命名空间:: System.Xml

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将给定的命名空间添加到集合。

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不检查并uri检查prefix符合性。

XmlReader 根据万维网联盟 (W3C) 命名空间规范检查名称（包括前缀和命名空间）以确保这些名称是有效的 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=“”定义默认命名空间为空命名空间

适用于

通过

XmlNamespaceManager.AddNamespace(String, String) 方法

定义

参数

例外

示例

注解

适用于

另请参阅

其他资源