XmlWriter.WriteQualifiedName(String, String) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlWriter.cs

Ha felül van bírálva egy származtatott osztályban, írja ki a névtér által minősített nevet. Ez a metódus megkeresi a megadott névtér hatókörében lévő előtagot.

public:
 virtual void WriteQualifiedName(System::String ^ localName, System::String ^ ns);

public virtual void WriteQualifiedName(string localName, string? ns);

abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit

Public Overridable Sub WriteQualifiedName (localName As String, ns As String)

Paraméterek

localName

String

Az írandó helyi név.

ns

String

A névtér URI-ja.

Kivételek

ArgumentException

localName vagy null vagy String.Empty.

localName érvénytelen név.

InvalidOperationException

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

A példa a következő elemet írja:

<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

Megjegyzések

Ha ns az aktuális alapértelmezett névtérre van leképezve, a rendszer nem hoz létre előtagot.

Attribútumértékek írásakor ez a metódus előtagot hoz létre, ha ns nem található. Elemtartalom írásakor kivételt jelent, ha ns nem található.

Note

Ha egy, a XmlWriter nem felülbírálásból származó osztályt a rendszer localName nem ellenőrzi érvényes W3C XML-névként. Ilyen esetben a metódus meghívása előtt a sztring érvényességét metódussal IsName lehet ellenőrizni.

A metódus aszinkron verziójáról lásd WriteQualifiedNameAsync: .