XmlNamespaceManager.AddNamespace(String, String) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Aggiunge alla raccolta lo spazio dei nomi specificato.

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)

Parametri

prefix
String

Prefisso da associare allo spazio dei nomi aggiunto. Usare String.Empty per aggiungere uno spazio dei nomi predefinito.

Nota Se viene usata la classe XmlNamespaceManager per risolvere gli spazi dei nomi in un'espressione XML Path Language (XPath), è necessario specificare un prefisso. Se in un'espressione XPath non è incluso un prefisso, si presuppone che l'URI (Uniform Resource Identifier) dello spazio dei nomi sia lo spazio dei nomi vuoto. Per ulteriori informazioni sulle espressioni XPath e su XmlNamespaceManager, fare riferimento a SelectNodes(String) e ai metodi SetContext(XmlNamespaceManager).

uri
String

Spazio dei nomi da aggiungere.

Eccezioni

ArgumentException

Il valore di prefix è "xml" o "xmlns".

ArgumentNullException

Il valore di prefix o uri è null.

Esempio

Nell'esempio seguente viene usato XmlNamespaceManager per risolvere gli spazi dei nomi in un frammento 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

Commenti

XmlNamespaceManager non verifica prefix e uri verifica la conformità.

XmlReader controlla i nomi, inclusi i prefissi e gli spazi dei nomi, per assicurarsi che siano nomi XML validi in base alla specifica World Wide Web Consortium (W3C). XmlNamespaceManager viene usato internamente da XmlReader, in modo da evitare una duplicazione degli sforzi, XmlNamespaceManager presuppone che tutti i prefissi e gli spazi dei nomi siano validi.

Se il prefisso e lo spazio dei nomi esistono già all'interno dell'ambito corrente, il nuovo prefisso e la coppia dello spazio dei nomi sostituiranno la combinazione di prefisso/spazio dei nomi esistente. La stessa combinazione di prefisso e spazio dei nomi può esistere in ambiti diversi.

Le coppie di prefisso/spazio dei nomi seguenti vengono aggiunte per impostazione predefinita a XmlNamespaceManager. Possono essere determinati in qualsiasi ambito.

Prefisso Spazio dei nomi
xmlns http://www.w3.org/2000/xmlns/ (spazio dei nomi dei prefissi xmlns)
Xml http://www.w3.org/XML/1998/namespace (spazio dei nomi XML)
String.Empty String.Empty (spazio dei nomi vuoto). Questo valore può essere riassegnare un prefisso diverso. Ad esempio, xmlns="" definisce lo spazio dei nomi predefinito come spazio dei nomi vuoto

Si applica a

Vedi anche