XmlNamespaceManager.LookupPrefix(String) Método

Definição

Encontra o prefixo declarado para o URI de namespace especificado.Finds the prefix declared for the given namespace URI.

public:
 virtual System::String ^ LookupPrefix(System::String ^ uri);
public virtual string LookupPrefix (string uri);
public virtual string? LookupPrefix (string uri);
abstract member LookupPrefix : string -> string
override this.LookupPrefix : string -> string
Public Overridable Function LookupPrefix (uri As String) As String

Parâmetros

uri
String

O namespace a ser resolvido para o prefixo.The namespace to resolve for the prefix.

Retornos

String

O prefixo correspondente.The matching prefix. Se não houver nenhum prefixo mapeado, o método retornará String.Empty.If there is no mapped prefix, the method returns String.Empty. Se um valor nulo for fornecido, null será retornado.If a null value is supplied, then null is returned.

Implementações

Exemplos

O exemplo a seguir mostra como usar o LookupPrefix método ao escrever um atributo.The following example shows how to use the LookupPrefix method when writing an attribute. Ele usa o XmlWriter.WriteStartAttribute método para iniciar o atributo, pesquisa o prefixo do URI do urn:samples namespace e, em seguida, usa esse prefixo no XmlWriter.WriteStartAttribute ao gravar o ISBN atributo:It uses the XmlWriter.WriteStartAttribute method to start the attribute, looks up the prefix for the urn:samples namespace URI, and then uses that prefix in the XmlWriter.WriteStartAttribute when writing the ISBN attribute:

Dim prefix As String = nsMgr.LookupPrefix("urn:samples")  
writer.WriteStartAttribute(prefix, "ISBN", "urn:samples")  
XmlNameTable nt = new XmlNameTable();  
XmlNamespaceManager nsMgr = new XmlNamespaceManager(nt);  
nsMgr.AddNamespace("bk","urn:samples");string prefix = writer nsMgr.LookupPrefix("urn:samples");  
writer.WriteStartAttribute(prefix, "ISBN", "urn:samples");  

O exemplo a seguir usa LookupPrefix para localizar o prefixo definido em um elemento.The following example uses LookupPrefix to find the prefix defined on an element.

writer.WriteStartElement("root", "book")  
writer.WriteStartElement("x", "node", "author")  
s = writer.LookupPrefix("author")  
CError.Compare(s, "x", "Error in nested element")  
writer.WriteEndElement()  
s = writer.LookupPrefix("book")  
CError.Compare(s, Nothing, "Error in root element")  
writer.WriteEndElement()  

SaídaOutput

<root xmlns="book">  
  <x:node xmlns:x="author" />   
</root>  

Comentários

Esse método localiza o prefixo mapeado percorrendo a pilha (ou seja, ela parece globalmente).This method finds the mapped prefix by walking the stack (that is, it looks globally). A cadeia de caracteres fornecida deve ser atomada para que a pesquisa seja realizada com sucesso.The supplied string must be atomized for the lookup to succeed. Em outras palavras, o objeto de cadeia de caracteres fornecido deve existir na tabela de nome do Gerenciador de namespace ( NameTable ).In other words, the supplied string object must exist in the namespace manager's name table (NameTable).

A cadeia de caracteres retornada também é atomada.The returned string is also atomized. Para obter mais informações sobre cadeias de caracteres atomizadas, veja a classe XmlNameTable.For more information on atomized strings, see the XmlNameTable class.

Aplica-se a

Confira também