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 saber mais e exemplos, siga os links para a página de referência para cada método ou propriedade.

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

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

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

O gerenciador de namespace pressupõe que prefixos e namespaces já foram verificados e estão em conformidade com a especificação de Namespaces W3C . O gerenciador de namespace 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 LookupNamespace método ou LookupPrefix .

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

Porque o gerenciador de namespace 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 namespace sobre a comparação direta de uma cadeia de caracteres.

O exemplo de código a seguir mostra como associar o prefixo xsd ao URI do namespace de http://www.w3.org/2001/XMLSchema 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 um 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)));  
}  

Construtores

Propriedades

Métodos

Métodos de Extensão

Aplica-se a

Confira também

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