XmlWriter.WriteQualifiedName(String, String) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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:
 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)

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

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již 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 zápisu obsahu elementu vyvolá výjimku, pokud ns nebyl nalezen.

Poznámka

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 pomocí IsName metody.

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