次の方法で共有


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。

例外

localNamenull または String.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 は例外をスローします。

Note

から XmlWriter 派生したクラスがオーバーライドされない場合、このメソッド localName は有効な W3C XML 名としてチェックされません。 このような場合、このメソッドを呼び出す前に、メソッドによって IsName 文字列の有効性を確認できます。

このメソッドの非同期バージョンについては、「」を参照してください WriteQualifiedNameAsync

適用対象