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:
 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 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.

適用対象