XmlWriter.WriteQualifiedName(String, String) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando ne viene eseguito l'override in una classe derivata, scrive il nome completo dello spazio dei nomi. Questo metodo esegue la ricerca del prefisso incluso nell'ambito dello spazio dei nomi specificato.

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)

Parametri

localName

String

Nome locale da scrivere.

ns

String

URI dello spazio dei nomi del nome.

Eccezioni

ArgumentException

localName è null o String.Empty.

localName non è un nome valido.

InvalidOperationException

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Nell'esempio viene scritto l'elemento seguente:

<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

Commenti

Se ns viene eseguito il mapping allo spazio dei nomi predefinito corrente, non viene generato alcun prefisso.

Quando si scrivono valori di attributo, questo metodo genera un prefisso se ns non viene trovato. Quando si scrive il contenuto dell'elemento, viene generata un'eccezione se ns non viene trovata.

Nota

Se una classe derivata da non esegue l'override XmlWriter di questo metodo localName non è selezionata come nome XML W3C valido. In questo caso, prima di chiamare questo metodo, la validità della stringa può essere controllata dal IsName metodo .

Per la versione asincrona di questo metodo, vedere WriteQualifiedNameAsync.