XmlWriter.WriteAttributeString メソッド

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

XmlWriter.WriteAttributeString メソッド (String, String, String, String)

派生クラスでオーバーライドされると、指定したプリフィックス、ローカル名、名前空間 URI、および値の属性を書き込みます。

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

Visual Basic (宣言)

Public Sub WriteAttributeString ( _
    prefix As String, _
    localName As String, _
    ns As String, _
    value As String _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim prefix As String
Dim localName As String
Dim ns As String
Dim value As String

instance.WriteAttributeString(prefix, localName, ns, value)

C#

public void WriteAttributeString (
    string prefix,
    string localName,
    string ns,
    string value
)

C++

public:
void WriteAttributeString (
    String^ prefix, 
    String^ localName, 
    String^ ns, 
    String^ value
)

J#

public void WriteAttributeString (
    String prefix, 
    String localName, 
    String ns, 
    String value
)

JScript

public function WriteAttributeString (
    prefix : String, 
    localName : String, 
    ns : String, 
    value : String
)

パラメータ

prefix

属性の名前空間プリフィックス。

localName

属性のローカル名。

ns

属性の名前空間 URI。

value

属性の値。

例外

例外の種類	条件
InvalidOperationException	ライタが WriteState.Element の状態にないか、またはライタが閉じています。
ArgumentException	xml:space 属性値または xml:lang 属性値が無効です。

解説

このメソッドは、ユーザー定義の名前空間プリフィックスを持つ属性を書き込み、指定した名前空間に関連付けます。プリフィックスが "xmlns" の場合、このメソッドは、これも名前空間宣言として扱い、宣言されたプリフィックスを指定した属性値で提供される名前空間 URI に関連付けます。この場合、ns 引数は null 参照 (Visual Basic では Nothing) でもかまいません。

WriteAttributeString は次の処理を実行します。

• 属性値に二重引用符または単一引用符が含まれている場合は、それぞれ " と ' に置き換えられます。

• xml:space 属性を書き込んでいる場合、ライタは、属性値が有効であることを検査します。有効な値は、preserve または default です。

• xml:lang 属性を書き込んでいる場合、ライタは、属性値が W3C 勧告『XML 1.0』に準拠して有効であることを検査しません。

使用例

WriteAttributeString メソッドを使用して名前空間宣言を書き込む例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main()
 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk",
 Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book",
 "1-800-925")

     writer.WriteElementString("price", "19.95")

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

  End Sub
End Class

C#

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

public class Sample {

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

     writer = XmlWriter.Create("sampledata.xml");
        
     // Write the root element.
     writer.WriteStartElement("book");

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null
,"urn:book");
  
     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

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

  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr,
 L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925"
 );
   writer->WriteElementString( L"price", L"19.95" );
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML to file and close the writer.
   writer->Flush();
   writer->Close();
}

プラットフォーム

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 の書き方

XmlWriter.WriteAttributeString メソッド

派生クラスでオーバーライドされると、指定した値の属性を書き込みます。
オーバーロードの一覧

名前	説明
XmlWriter.WriteAttributeString (String, String)	派生クラスでオーバーライドされると、指定したローカル名と値の属性を書き込みます。 .NET Compact Framework によってサポートされています。
XmlWriter.WriteAttributeString (String, String, String)	派生クラスでオーバーライドされると、指定したローカル名、名前空間 URI、および値の属性を書き込みます。 .NET Compact Framework によってサポートされています。
XmlWriter.WriteAttributeString (String, String, String, String)	派生クラスでオーバーライドされると、指定したプリフィックス、ローカル名、名前空間 URI、および値の属性を書き込みます。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間

その他の技術情報

XmlWriter による XML の書き方
XmlWriter による XML の書き方

XmlWriter による XML の書き方