XmlWriter.WriteAttributeString メソッド

リファレンス

定義

名前空間:: System.Xml

アセンブリ:: System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

注釈

このメソッドの非同期バージョンについては、次を参照してください WriteElementStringAsync。

WriteAttributeString(String, String, String, String)

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

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

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

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

member this.WriteAttributeString : string * string * string * string -> unit

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

パラメーター

prefix: String

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

localName: String

属性のローカル名。

ns: String

属性の名前空間 URI。

value: String

属性の値。

例外

InvalidOperationException

ライターが WriteState.Element の状態にないか、またはライターが閉じています。

または - 先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentException

xml:space 属性値または xml:lang 属性値が無効です。

XmlException

localName または ns が null です。

例

次の例では、このメソッドを WriteAttributeString 使用して名前空間宣言を記述します。

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

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

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

注釈

このメソッドは、ユーザー定義の名前空間プレフィックスを持つ属性を書き出し、それを特定の名前空間に関連付けます。プレフィックスが "xmlns" の場合、このメソッドはこれを名前空間宣言として扱い、宣言されたプレフィックスを、指定された属性値で指定された名前空間 URI に関連付けます。この場合、引数nullは ns .

WriteAttributeString では次の処理が行われます。

属性値に二重引用符または一重引用符が含まれている場合は、それぞれ置換"``'されます。
属性を書き込む xml:space 場合、ライターは属性値が有効であることを確認します。 (有効な値は、 preserve または default.)
属性を記述する xml:lang 場合、ライターは W3C XML 1.0 の推奨事項に従って属性値が有効であることを確認しません。

このメソッドの非同期バージョンについては、次を参照してください WriteAttributeStringAsync。

適用対象

WriteAttributeString(String, String, String)

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

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

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

public void WriteAttributeString (string localName, string? ns, string? value);

member this.WriteAttributeString : string * string * string -> unit

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

パラメーター

localName: String

属性のローカル名。

ns: String

属性に関連付ける名前空間 URI。

value: String

属性の値。

例外

InvalidOperationException

ライターが WriteState.Element の状態にないか、またはライターが閉じています。

または - 先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentException

xml:space 属性値または xml:lang 属性値が無効です。

例

次の例では、このメソッドを WriteAttributeString 使用して名前空間宣言を記述します。

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

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

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

注釈

このメソッドは、ユーザー定義の名前空間プレフィックスを持つ属性を書き出し、それを特定の名前空間に関連付けます。 "xmlns" の場合 localName 、このメソッドはこれを名前空間宣言として扱います。この場合、引数は ns . です null。

WriteAttributeString では次の処理が行われます。

属性値に二重引用符または一重引用符が含まれている場合は、それぞれ置換"``'されます。
属性を書き込む xml:space 場合、ライターは属性値が有効であることを確認します。 (有効な値は、 preserve または default.)
属性を記述する xml:lang 場合、ライターは W3C XML 1.0 の推奨事項に従って属性値が有効であることを確認しません。

このメソッドの非同期バージョンについては、次を参照してください WriteAttributeStringAsync。

適用対象

WriteAttributeString(String, String)

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

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ value);

public void WriteAttributeString (string localName, string value);

public void WriteAttributeString (string localName, string? value);

member this.WriteAttributeString : string * string -> unit

Public Sub WriteAttributeString (localName As String, value As String)

パラメーター

localName: String

属性のローカル名。

value: String

属性の値。

例外

InvalidOperationException

ライターが WriteState.Element の状態にないか、またはライターが閉じています。

または -

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentException

xml:space 属性値または xml:lang 属性値が無効です。

例

次の例では、書籍を書き出します。

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"hardcover" );
         
         // Write the close tag for the root element.
         writer->WriteEndElement();
         
         // Write the XML to file and close the writer.
         writer->Flush();
         writer->Close();
      }
      finally
      {
         if ( writer != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}

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

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

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

        // Write the price.
        writer.WriteElementString("price", "19.95");

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

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

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

      finally {
        if (writer != null)
           writer.Close();
     }
   }
 }

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared m_Document As String = "sampledata.xml"
    
    Public Shared Sub Main()
        Dim writer As XmlWriter = Nothing
        
      Try

        Dim settings As XmlWriterSettings = new XmlWriterSettings()
        settings.Indent = true
        writer = XmlWriter.Create (m_Document, settings)
            
        writer.WriteComment("sample XML fragment")
            
        ' Write an element (this one is the root).
        writer.WriteStartElement("book")
            
        ' Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", Nothing, "urn:samples")
            
        ' Write the genre attribute.
        writer.WriteAttributeString("genre", "novel")
            
        ' Write the title.
        writer.WriteStartElement("title")
        writer.WriteString("The Handmaid's Tale")
        writer.WriteEndElement()
            
        ' Write the price.
        writer.WriteElementString("price", "19.95")
            
        ' Lookup the prefix and write the ISBN element.
        Dim prefix As String = writer.LookupPrefix("urn:samples")
        writer.WriteStartElement(prefix, "ISBN", "urn:samples")
        writer.WriteString("1-861003-78")
        writer.WriteEndElement()
            
        ' Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover")
            
        ' Write the close tag for the root element.
        writer.WriteEndElement()
            
        ' Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        Finally
            If Not (writer Is Nothing) Then
                writer.Close()
            End If
        End Try

    End Sub
End Class

注釈

WriteAttributeString では次の処理が行われます。

属性値に二重引用符または一重引用符が含まれている場合は、それぞれ置換"``'されます。
属性を書き込む xml:space 場合、ライターは属性値が有効であることを確認します。 (有効な値は、 preserve または default.)
属性を記述する xml:lang 場合、ライターは W3C XML 1.0 の推奨事項に従って属性値が有効であることを確認しません。

このメソッドの非同期バージョンについては、次を参照してください WriteAttributeStringAsync。

適用対象

XmlWriter.WriteAttributeString メソッド

定義

オーバーロード

注釈

WriteAttributeString(String, String, String, String)

パラメーター

例外

例

注釈

適用対象

WriteAttributeString(String, String, String)

パラメーター

例外

例

注釈

適用対象

WriteAttributeString(String, String)

パラメーター

例外

例

注釈

適用対象

その他のリソース