XmlWriter.WriteQualifiedName(String, String) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše kvalifikovaný název oboru názvů. Tato metoda vyhledá předponu, která je v oboru pro daný obor názvů.

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)

Parametry

localName

String

Místní název, který se má napsat.

ns

String

Identifikátor URI oboru názvů pro název.

Výjimky

ArgumentException

localName je buď null nebo String.Empty.

localName není platný název.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Příklady

Příklad zapíše následující prvek:

<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

Poznámky

Pokud ns se mapuje na aktuální výchozí obor názvů, nevygeneruje se žádná předpona.

Při zápisu hodnot atributů tato metoda vygeneruje předponu, pokud ns nebyla nalezena. Při psaní obsahu elementu vyvolá výjimku, pokud ns nebyl nalezen.

Note

Pokud třída odvozená z této XmlWriter metody nepřepíše tuto metodu localName není kontrolována jako platný název W3C XML. V takovém případě lze platnost řetězce před voláním této metody zkontrolovat metodou IsName .

Asynchronní verzi této metody naleznete v tématu WriteQualifiedNameAsync.