XmlWriter.WriteQualifiedName(String, String) メソッド

定義

名前空間:
System.Xml
アセンブリ:
System.Xml.dll, System.Xml.ReaderWriter.dll
アセンブリ:
netstandard.dll, System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.dll
アセンブリ:
netstandard.dll
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs

派生クラスでオーバーライドされると、名前空間修飾名を書き出します。 このメソッドは、指定された名前空間のスコープ内にあるプレフィックスを検索します。

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。

例外

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 が見つからない場合は例外がスローされます。

Note

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

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

適用対象