XmlWriter.WriteQualifiedName(String, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Quando substituído em uma classe derivada, grava o nome qualificado do namespace. Este método pesquisa o prefixo que está no escopo para o namespace fornecido.
public:
virtual void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public:
abstract void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public virtual void WriteQualifiedName (string localName, string ns);
public virtual void WriteQualifiedName (string localName, string? ns);
public abstract void WriteQualifiedName (string localName, string ns);
abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit
abstract member WriteQualifiedName : string * string -> unit
Public Overridable Sub WriteQualifiedName (localName As String, ns As String)
Public MustOverride Sub WriteQualifiedName (localName As String, ns As String)
Parâmetros
- localName
- String
O nome local a ser gravado.
- ns
- String
O URI do namespace para o nome.
Exceções
Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.
Exemplos
O exemplo grava o seguinte elemento:
<root xmlns:x="urn:abc">
<item href="#x:test"/>
</root>
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
using (XmlWriter writer = XmlWriter.Create(Console.Out, settings))
{
writer.WriteStartElement("root");
writer.WriteAttributeString("xmlns", "x", null, "urn:abc");
writer.WriteStartElement("item");
writer.WriteStartAttribute("href", null);
writer.WriteString("#");
writer.WriteQualifiedName("test", "urn:abc");
writer.WriteEndAttribute();
writer.WriteEndElement();
writer.WriteEndElement();
}
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.OmitXmlDeclaration = True
Using writer As XmlWriter = XmlWriter.Create(Console.Out, settings)
writer.WriteStartElement("root")
writer.WriteAttributeString("xmlns", "x", Nothing, "urn:abc")
writer.WriteStartElement("item")
writer.WriteStartAttribute("href", Nothing)
writer.WriteString("#")
writer.WriteQualifiedName("test", "urn:abc")
writer.WriteEndAttribute()
writer.WriteEndElement()
writer.WriteEndElement()
End Using
Comentários
Se ns
for mapeado para o namespace padrão atual, nenhum prefixo será gerado.
Ao gravar valores de atributo, esse método gera um prefixo se ns
não for encontrado. Ao gravar o conteúdo do elemento, ele gerará uma exceção se ns
não for encontrado.
Observação
Se uma classe derivada do XmlWriter não substituir esse método localName
não for verificada como um nome XML W3C válido. Nesse caso, antes de chamar esse método, a validade da cadeia de caracteres pode ser verificada pelo IsName método .
Para obter a versão assíncrona desse método, consulte WriteQualifiedNameAsync.