XmlWriter.WriteQualifiedName メソッド

.NET Framework クラス ライブラリ リファレンス

XmlWriter.WriteQualifiedName メソッド

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub WriteQualifiedName
 ( _
    localName As String, _
    ns As String _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim localName As String
Dim ns As String

instance.WriteQualifiedName(localName, ns)

C#

public virtual void WriteQualifiedName (
    string localName,
    string ns
)

C++

public:
virtual void WriteQualifiedName (
    String^ localName, 
    String^ ns
)

J#

public void WriteQualifiedName (
    String localName, 
    String ns
)

JScript

public function WriteQualifiedName (
    localName : String, 
    ns : String
)

パラメータ

localName

書き込むローカル名。

ns

名前の名前空間 URI。

例外

例外の種類	条件
ArgumentException	localName が null 参照 (Visual Basic では Nothing) または String.Empty のいずれかです。 localName が有効な名前ではありません。

解説

ns を現在の既定の名前空間に割り当てると、プリフィックスは生成されません。

属性値を書き込むときに ns が見つからないと、このメソッドはプリフィックスを生成します。要素の内容を書き込むときに ns が見つからないと、このメソッドは例外をスローします。

使用例

次の要素を書き込む例を示します。

<root xmlns:x="urn:abc">
  <item href="#x:test"/>
</root>

Visual Basic

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

C#

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();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方