XmlNamespaceManager Classe

Definição

public ref class XmlNamespaceManager : System::Collections::IEnumerable, System::Xml::IXmlNamespaceResolver

public ref class XmlNamespaceManager : System::Collections::IEnumerable

public class XmlNamespaceManager : System.Collections.IEnumerable, System.Xml.IXmlNamespaceResolver

public class XmlNamespaceManager : System.Collections.IEnumerable

type XmlNamespaceManager = class
    interface IEnumerable
    interface IXmlNamespaceResolver

type XmlNamespaceManager = class
    interface IEnumerable

type XmlNamespaceManager = class
    interface IXmlNamespaceResolver
    interface IEnumerable

Public Class XmlNamespaceManager
Implements IEnumerable, IXmlNamespaceResolver

Public Class XmlNamespaceManager
Implements IEnumerable

Herança

Object

XmlNamespaceManager

Derivado

System.Windows.Data.XmlNamespaceMappingCollection

System.Xml.Xsl.XsltContext

Implementações

IEnumerable IXmlNamespaceResolver

Comentários

Para obter informações gerais sobre como os namespaces são declarados e usados em documentos XML, consulte Gerenciando namespaces em um documento XML.

XmlNamespaceManager armazena prefixos e namespaces como cadeias de caracteres. Aqui está um resumo das tarefas de gerenciamento e pesquisa que você pode executar com essa classe. Para obter mais informações e exemplos, siga os links para a página de referência para cada método ou propriedade.

Para adicionar namespaces ao gerenciador de namespaces, crie um XmlNamespaceManager objeto e use o AddNamespace método. Os pares de prefixo e namespace padrão são adicionados automaticamente ao gerenciador de namespaces na criação.

Ao criar o gerenciador de namespaces, você pode especificar uma tabela de nomes da XmlReaderclasse ou XsltContextXmlDocument da classe e, em seguida, usar o AddNamespace método para adicionar os namespaces.

Você pode fornecer o XmlNamespaceManager objeto como um parâmetro para o método ou SelectSingleNode o SelectNodes método da XmlDocument classe para executar expressões de consulta XPath que fazem referência a nomes de atributos e elementos qualificados para namespace.

O gerenciador de namespaces pressupõe que prefixos e namespaces já foram verificados e estão em conformidade com a especificação de Namespaces W3C . O gerenciador de namespaces não executa nenhuma validação.

O gerenciador de namespace atomiza as cadeias de caracteres quando elas são adicionadas usando o AddNamespace método e quando uma pesquisa é executada usando o método ou LookupPrefix o LookupNamespace método.

O gerenciador de namespace implementa o suporte à enumeração, além de adicionar e recuperar namespaces. Você pode executar um loop pelas informações salvas no gerenciador de namespaces usando o foreach constructo. Por exemplo, se você criar um gerenciador de namespaces com o nome nsmanager, poderá iterar pela tabela usando foreach (String prefix in nsmanager).

Como o gerenciador de namespaces fornece uma comparação de cadeia de caracteres com o prefixo e namespaces como objetos, há uma melhoria de desempenho ao usar o gerenciador de namespaces na comparação direta de uma cadeia de caracteres.

O exemplo de código a seguir mostra como associar o prefixo xsd ao URI do http://www.w3.org/2001/XMLSchema namespace e adicioná-lo ao gerenciador de namespace:

nsmgr.AddNamespace("xsd", "http://www.w3.org/2001/XMLSchema")

nsmgr.AddNamespace("xsd", "http://www.w3.org/2001/XMLSchema");

Em seguida, você pode encontrar o namespace usando o LookupNamespace método:

nsmgr.LookupNamespace("xsd")

nsmgr.LookupNamespace("xsd");

O exemplo a seguir cria uma XmlNamespaceManager usando a tabela de nomes de um leitor XML:

Dim reader As New XmlTextReader("myfile.xml")
Dim nsmanager As New XmlNamespaceManager(reader.NameTable)
nsmanager.AddNamespace("msbooks", "www.microsoft.com/books")
nsmanager.PushScope()
nsmanager.AddNamespace("msstore", "www.microsoft.com/store")
While reader.Read()
    Console.WriteLine("Reader Prefix:{0}", reader.Prefix)
    Console.WriteLine("XmlNamespaceManager Prefix:{0}",
     nsmanager.LookupPrefix(nsmanager.NameTable.Get(reader.NamespaceURI)))
End While

XmlTextReader reader = new XmlTextReader("myfile.xml");
XmlNamespaceManager nsmanager = new XmlNamespaceManager(reader.NameTable);
nsmanager.AddNamespace("msbooks", "www.microsoft.com/books");
nsmanager.PushScope();
nsmanager.AddNamespace("msstore", "www.microsoft.com/store");
while (reader.Read())
{
    Console.WriteLine("Reader Prefix:{0}", reader.Prefix);
    Console.WriteLine("XmlNamespaceManager Prefix:{0}",
    nsmanager.LookupPrefix(nsmanager.NameTable.Get(reader.NamespaceURI)));
}

Confira também

• Documentos e dados XML
• Gerenciando namespaces em um documento XML