Udostępnij za pośrednictwem


XmlWriter.WriteQualifiedName(String, String) Metoda

Definicja

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(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

Nazwa lokalna do zapisania.

ns
String

Identyfikator URI przestrzeni nazw dla nazwy.

Wyjątki

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

localName nie jest prawidłową nazwą.

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();
}
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

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