XmlWriter.WriteQualifiedName(String, String) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Türetilmiş bir sınıfta geçersiz kılındığında, ad alanı nitelenmiş adını yazar. Bu yöntem, verilen ad alanının kapsamındaki ön eki arar.

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)

Parametreler

localName

String

Yazacak yerel ad.

ns

String

Adın ad alanı URI'si.

Özel durumlar

ArgumentException

localName, null ya da String.Empty olur.

localName geçerli bir ad değil.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Örnek aşağıdaki öğeyi yazar:

<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

Açıklamalar

Geçerli varsayılan ad alanıyla eşleniyorsa ns , ön ek oluşturulmaz.

Öznitelik değerleri yazarken, bu yöntem bulunamazsa ns bir ön ek oluşturur. Öğe içeriği yazarken, bulunamazsa ns bir özel durum oluşturur.

Not

öğesinden XmlWriter türetilen bir sınıf geçersiz kılmazsa, bu yöntem localName geçerli bir W3C XML adı olarak işaretlenmez. Böyle bir durumda, bu yöntemi çağırmadan önce dizenin geçerliliği yöntem tarafından IsName denetlenebilir.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteQualifiedNameAsync. .