XmlTextWriter.WriteQualifiedName メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

XmlTextWriter.WriteQualifiedName メソッド

名前空間の限定名を書き込みます。このメソッドは、指定した名前空間のスコープ内にあるプリフィックスを検索します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As XmlTextWriter
Dim localName As String
Dim ns As String

instance.WriteQualifiedName(localName, ns)

public override void WriteQualifiedName (
    string localName,
    string ns
)

C++

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

public void WriteQualifiedName (
    String localName, 
    String ns
)

JScript

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

パラメータ

localName: 書き込むローカル名。

ns: 名前に関連付ける名前空間 URI。

例外

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

例外の種類

条件

ArgumentException

localName が null 参照 (Visual Basic では Nothing) または String.Empty のいずれかです。

localName が、W3C の名前空間の仕様に準拠した有効な名前ではありません。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlWriter.Create メソッドと XmlWriterSettings クラスを使用して XmlWriter インスタンスを作成することをお勧めします。これにより、このリリースで導入されたすべての新機能を十分に活用できます。詳細については、「XML ライタの作成」を参照してください。

メモ

Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlWriter.Create メソッドと XmlWriterSettings クラスを使用して XmlWriter インスタンスを作成することをお勧めします。これにより、このリリースで導入されたすべての新機能を十分に活用できます。詳細については、「XML ライタの作成」を参照してください。

Microsoft Visual 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 が見つからないと、このメソッドは例外をスローします。

このライタが名前空間をサポートしている (Namespaces が true に設定されている) 場合、このメソッドは、その名前が W3C 勧告『Namespaces in XML』(http://www.w3.org/TR/REC-xml-names) に準拠した有効な名前かどうかも確認します。

使用例

XSD スキーマの一部を書き込む例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared filename As
 String = "sampledata.xml"
    Public Shared Sub Main()
        Dim writer As XmlTextWriter = Nothing
        
        writer = New XmlTextWriter(filename, Nothing)
        ' Use indenting for readability.
        writer.Formatting = Formatting.Indented
        
        ' Write the root element.
        writer.WriteStartElement("schema")
        
        ' Write the namespace declarations.
        writer.WriteAttributeString("xmlns", Nothing,
 "http://www.w3.org/2001/XMLSchema")
        writer.WriteAttributeString("xmlns", "po",
 Nothing, "http://contoso.com/po")
        
        writer.WriteStartElement("element")
        
        writer.WriteAttributeString("name", "purchaseOrder")
        
        ' Write the type attribute.
        writer.WriteStartAttribute(Nothing, "type",
 Nothing)
        writer.WriteQualifiedName("PurchaseOrder",
 "http://contoso.com/po")
        writer.WriteEndAttribute()
        
        writer.WriteEndElement()
        
        ' Write the close tag for the root element.
        writer.WriteEndElement()
        
        ' Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        ' Read the file back in and parse to ensure well formed XML.
        Dim doc As New XmlDocument()
        ' Preserve white space for readability.
        doc.PreserveWhitespace = True
        ' Load the file.
        doc.Load(filename)
        
        ' Write the XML content to the console.
        Console.Write(doc.InnerXml)
    End Sub 'Main 
End Class 'Sample

using System;
using System.IO;
using System.Xml;

public class Sample
{
  private const string filename
 = "sampledata.xml";

  public static void Main()
  {
     XmlTextWriter writer = null;

     writer = new XmlTextWriter (filename, null);
     // Use indenting for readability.
     writer.Formatting = Formatting.Indented;
        
     // Write the root element.
     writer.WriteStartElement("schema");

     // Write the namespace declarations.
     writer.WriteAttributeString("xmlns", null,"http://www.w3.org/2001/XMLSchema");
     writer.WriteAttributeString("xmlns","po",null
,"http://contoso.com/po");

     writer.WriteStartElement("element");

     writer.WriteAttributeString("name", "purchaseOrder");

     // Write the type attribute.
     writer.WriteStartAttribute(null,"type", null);
     writer.WriteQualifiedName("PurchaseOrder", "http://contoso.com/po");
     writer.WriteEndAttribute();

     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();
             
     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();  

     // Read the file back in and parse to ensure well formed XML.
     XmlDocument doc = new XmlDocument();
     // Preserve white space for readability.
     doc.PreserveWhitespace = true;
     // Load the file.
     doc.Load(filename);
    
     // Write the XML content to the console.
     Console.Write(doc.InnerXml);

  }

}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextWriter^ writer = nullptr;
   String^ filename = "sampledata.xml";
   writer = gcnew XmlTextWriter( filename, nullptr );
   
   // Use indenting for readability.
   writer->Formatting = Formatting::Indented;
   
   // Write the root element.
   writer->WriteStartElement( "schema" );
   
   // Write the namespace declarations.
   writer->WriteAttributeString( "xmlns", nullptr, "http://www.w3.org/2001/XMLSchema"
 );
   writer->WriteAttributeString( "xmlns", "po", nullptr, "http://contoso.com/po"
 );
   writer->WriteStartElement( "element" );
   writer->WriteAttributeString( "name", "purchaseOrder" );
   
   // Write the type attribute.
   writer->WriteStartAttribute( nullptr, "type", nullptr );
   writer->WriteQualifiedName( "PurchaseOrder", "http://contoso.com/po"
 );
   writer->WriteEndAttribute();
   writer->WriteEndElement();
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML to file and close the writer.
   writer->Flush();
   writer->Close();
   
   // Read the file back in and parse to ensure well formed XML.
   XmlDocument^ doc = gcnew XmlDocument;
   
   // Preserve white space for readability.
   doc->PreserveWhitespace = true;
   
   // Load the file.
   doc->Load( filename );
   
   // Write the XML content to the console.
   Console::Write( doc->InnerXml );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    private static String fileName = "sampledata.xml";

    public static void main(String[]
 args)
    {
        XmlTextWriter writer = null;
        writer = new XmlTextWriter(fileName, null);

        // Use indenting for readability.
        writer.set_Formatting(Formatting.Indented);

        // Write the root element.
        writer.WriteStartElement("schema");

        // Write the namespace declarations.
        writer.WriteAttributeString("xmlns", null,
            "http://www.w3.org/2001/XMLSchema");
        writer.WriteAttributeString("xmlns", "po", null
,
            "http://contoso.com/po");
        writer.WriteStartElement("element");
        writer.WriteAttributeString("name", "purchaseOrder");

        // Write the type attribute.
        writer.WriteStartAttribute(null, "type", null);
        writer.WriteQualifiedName("PurchaseOrder", "http://contoso.com/po");
        writer.WriteEndAttribute();
        writer.WriteEndElement();

        // Write the close tag for the root element.
        writer.WriteEndElement();

        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();

        // Read the file back in and parse to ensure well formed XML.
        XmlDocument doc = new XmlDocument();

        // Preserve white space for readability.
        doc.set_PreserveWhitespace(true);

        // Load the file.
        doc.Load(fileName);

        // Write the XML content to the console.
        Console.Write(doc.get_InnerXml());
    } //main 
} //Sample

プラットフォーム

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

参照

関連項目
XmlTextWriter クラス
XmlTextWriter メンバ
System.Xml 名前空間

このページでは「.NET Framework クラスライブラリリファレンス」からXmlTextWriter.WriteQualifiedName メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からXmlTextWriter.WriteQualifiedName メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からXmlTextWriter.WriteQualifiedName メソッドを検索

>> 「XmlTextWriter.WriteQualifiedName メソッド」を含む用語の索引
XmlTextWriter.WriteQualifiedName メソッドのページへのリンク


	© 2025 Microsoft.All rights reserved.

XmlTextWriter.WriteQualifiedName メソッドとは？ わかりやすく解説

XmlTextWriter.WriteQualifiedName メソッド

XmlTextWriter.WriteQualifiedName メソッドとは？わかりやすく解説