XmlWriter.WriteQualifiedName(String, String) Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Źródło:

XmlWriter.cs

Po zastąpieniu w klasie pochodnej zapisuje kwalifikowaną nazwę przestrzeni nazw. Ta metoda wyszukuje prefiks, który jest w zakresie dla danej przestrzeni nazw.

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

Parametry

localName

String

Nazwa lokalna do zapisania.

ns

String

Identyfikator URI przestrzeni nazw dla nazwy.

Wyjątki

ArgumentException

Parametr localName ma wartość null lub String.Empty.

localName nie jest prawidłową nazwą.

InvalidOperationException

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

W przykładzie jest zapisywany następujący 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();
}

Uwagi

Jeśli ns mapuje na bieżącą domyślną przestrzeń nazw, nie jest generowany żaden prefiks.

Podczas pisania wartości atrybutów ta metoda generuje prefiks, jeśli ns nie zostanie znaleziony. Podczas pisania zawartości elementu zgłasza wyjątek, jeśli ns nie zostanie znaleziony.

Uwaga

Jeśli klasa pochodząca z XmlWriter klasy nie zastępuje tej metody localName , nie jest sprawdzana jako prawidłowa nazwa XML W3C. W takim przypadku przed wywołaniem tej metody można sprawdzić poprawność ciągu przy użyciu IsName metody.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteQualifiedNameAsync.

Dotyczy