共用方式為


XmlWriter.WriteQualifiedName(String, String) 方法

定義

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

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)

參數

localName
String

要寫入的區域名稱。

ns
String

這個名稱的命名空間 URI。

例外狀況

localNamenullString.Empty

localName 不是有效的名稱。

在先前的非同步作業完成前呼叫了 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

適用於