XmlWriter.WriteQualifiedName(String, String) Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs

När du åsidosättas i en härledd klass skriver du ut det namnområdeskvalificerade namnet. Den här metoden letar upp prefixet som finns i omfånget för det angivna namnområdet.

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)

Parametrar

localName
String

Det lokala namn som ska skrivas.

ns
String

Namnområdes-URI:n för namnet.

Undantag

ArgumentException

localName är antingen null eller String.Empty.

localName är inte ett giltigt namn.

InvalidOperationException

En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Exempel

Exemplet skriver följande element:

<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

Kommentarer

Om ns mappas till det aktuella standardnamnområdet genereras inget prefix.

När du skriver attributvärden genererar den här metoden ett prefix om ns det inte hittas. När du skriver elementinnehåll utlöser det ett undantag om ns det inte hittas.

Note

Om en klass som härleds från XmlWriter inte åsidosätter den här metoden localName inte är markerad som ett giltigt W3C XML-namn. I sådana fall kan strängens giltighet kontrolleras IsName med metod innan du anropar den här metoden.

Den asynkrona versionen av den här metoden finns i WriteQualifiedNameAsync.

Gäller för