XmlWriter.WriteQualifiedName メソッド
派生クラスでオーバーライドされると、名前空間の限定名を書き込みます。このメソッドは、指定した名前空間のスコープ内にあるプリフィックスを検索します。
Public MustOverride Sub WriteQualifiedName( _
ByVal localName As String, _ ByVal ns As String _)
[C#]
public abstract void WriteQualifiedName(stringlocalName,stringns);
[C++]
public: virtual void WriteQualifiedName(String* localName,String* ns) = 0;
[JScript]
public abstract function WriteQualifiedName(
localName : String,ns : String);
パラメータ
- localName
書き込むローカル名。 - ns
名前の名前空間 URI。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentException | localName が null 参照 (Visual Basic では Nothing) または String.Empty です。
localName が有効な名前ではありません。 |
解説
C# コード例を次に示します。
writer.Formatting = Formatting.Indented;
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();
writer.Close();
次の出力を生成します。
<root xmlns:x="urn:abc">
<item href="#x:test"/>
</root>
ns を現在の既定の名前空間に割り当てると、プリフィックスは生成されません。
属性値を書き込むときに ns が見つからないと、このメソッドはプリフィックスを生成します。要素の内容を書き込むときに ns が見つからないと、このメソッドは例外をスローします。
使用例
このメソッドの使用例については、 WriteQualifiedName (XmlTextWriter クラス) のトピックを参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard