XmlWriter.WriteQualifiedName(String, String) XmlWriter.WriteQualifiedName(String, String) XmlWriter.WriteQualifiedName(String, String) XmlWriter.WriteQualifiedName(String, String) Method

定義

派生クラスでオーバーライドされると、名前空間の限定名を書き込みます。When overridden in a derived class, writes out the namespace-qualified name. このメソッドは、指定した名前空間のスコープ内にあるプレフィックスを検索します。This method looks up the prefix that is in scope for the given namespace.

public:
 abstract void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public abstract void WriteQualifiedName (string localName, string ns);
abstract member WriteQualifiedName : string * string -> unit
Public MustOverride Sub WriteQualifiedName (localName As String, ns As String)

パラメーター

localName
String String String String

書き込むローカル名。The local name to write.

ns
String String String String

名前の名前空間 URI。The namespace URI for the name.

例外

localNamenull または String.Empty です。localName is either null or String.Empty.

localName が有効な名前ではありません。localName is not a valid name.

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

この例では、次の要素を書き込みます。The example writes the following element:

<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現在の既定の名前空間にマップされている場合、プレフィックスは生成されません。If ns maps to the current default namespace, no prefix is generated.

属性値を書き込むときに、が見つからない場合ns 、このメソッドはプレフィックスを生成します。When writing attribute values, this method generates a prefix if ns is not found. 要素の内容を書き込むときに、が見つからnsない場合は例外をスローします。When writing element content, it throws an exception if ns is not found.

注意

から派生したクラスがXmlWriterをオーバーライドしない場合localName 、このメソッドは有効な W3C XML 名としてチェックされません。If a class derived from the XmlWriter does not override this method localName is not checked to be a valid W3C XML name. このような場合は、このメソッドを呼び出す前に、メソッドによってIsName文字列の有効性を確認できます。In such case, before calling this method, the validity of the string can be checked by IsName method.

このメソッドの非同期バージョンについてはWriteQualifiedNameAsync、「」を参照してください。For the asynchronous version of this method, see WriteQualifiedNameAsync.

適用対象