XmlWriter.WriteQualifiedName(String, String) 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlWriter.cs

在衍生類別中覆寫時，寫出命名空間限定名稱。 這個方法會查詢在指定之命名空間範圍中的前置詞。

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)

參數

localName

String

要寫入的區域名稱。

ns

String

這個名稱的命名空間 URI。

例外狀況

ArgumentException

localName 為 null 或 String.Empty。

localName 不是有效的名稱。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

範例

此範例會寫入下列專案：

<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

備註

如果 ns 對應至目前的預設命名空間，則不會產生前置詞。

寫入屬性值時，如果 ns 找不到，這個方法會產生前置詞。 寫入專案內容時，如果 ns 找不到，則會擲回例外狀況。

注意

如果衍生自 的 XmlWriter 類別未覆寫此方法 localName ，則不會檢查為有效的 W3C XML 名稱。 在這種情況下，在呼叫這個方法之前，可以透過 IsName 方法檢查字串的有效性。

如需這個方法的非同步版本，請參閱 WriteQualifiedNameAsync 。