XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString Method

定義

派生クラスでオーバーライドされると、指定した値の属性を書き込みます。When overridden in a derived class, writes an attribute with the specified value.

オーバーロード

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

派生クラスでオーバーライドされると、指定したローカル名、名前空間 URI、および値の属性を書き込みます。When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

派生クラスでオーバーライドされると、指定したプリフィックス、ローカル名、名前空間 URI、および値の属性を書き込みます。When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

派生クラスでオーバーライドされると、指定したローカル名と値の属性を書き込みます。When overridden in a derived class, writes out the attribute with the specified local name and value.

注釈

このメソッドの非同期バージョンを参照してください。WriteElementStringAsyncします。For the asynchronous version of this method, see WriteElementStringAsync.

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

派生クラスでオーバーライドされると、指定したローカル名、名前空間 URI、および値の属性を書き込みます。When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ ns, System::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 String String String

属性のローカル名。The local name of the attribute.

ns
String String String String

属性に関連付ける名前空間 URI。The namespace URI to associate with the attribute.

value
String String String String

属性の値。The value of the attribute.

例外

ライターが WriteState.Element の状態にないか、またはライターが閉じています。The state of writer is not WriteState.Element or writer is closed.

または-or- 先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

xml:space 属性値または xml:lang 属性値が無効です。The xml:space or xml:lang attribute value is invalid.

次の例では、WriteAttributeString名前空間宣言を書き込みます。The following example uses the WriteAttributeString method to write a namespace declaration.

#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
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

注釈

このメソッドでは、ユーザー定義の名前空間プレフィックスを持つ属性を書き込み、指定した名前空間に関連付けます。This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. 場合localName"xmlns"は、このメソッドもこのとして扱います名前空間宣言。If localName is "xmlns" then this method also treats this as a namespace declaration. ここで、ns引数を指定できますnullします。In this case, the ns argument can be null.

WriteAttributeString では次の処理が行われます。WriteAttributeString does the following:

  • 属性値には、二重引用符または単一引用符が含まれている場合に置き換えられます&quot;&apos;それぞれします。If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • 書き込む場合、xml:space属性値が有効では、属性、ライターを確認します。If writing an xml:space attribute, the writer verifies the attribute value is valid. (有効な値はpreserveまたはdefault)。(Valid values are preserve or default.)

  • 書き込む場合、xml:lang属性、ライターは検証されません属性値が w3c 勧告 『 XML 1.0 勧告有効であります。If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

このメソッドの非同期バージョンを参照してください。WriteAttributeStringAsyncします。For the asynchronous version of this method, see WriteAttributeStringAsync.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

派生クラスでオーバーライドされると、指定したプリフィックス、ローカル名、名前空間 URI、および値の属性を書き込みます。When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

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);
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 String String String

属性の名前空間プレフィックス。The namespace prefix of the attribute.

localName
String String String String

属性のローカル名。The local name of the attribute.

ns
String String String String

属性の名前空間 URI。The namespace URI of the attribute.

value
String String String String

属性の値。The value of the attribute.

例外

ライターが WriteState.Element の状態にないか、またはライターが閉じています。The state of writer is not WriteState.Element or writer is closed.

または-or- 先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

xml:space 属性値または xml:lang 属性値が無効です。The xml:space or xml:lang attribute value is invalid.

localName または nsnull です。The localName or ns is null.

次の例では、WriteAttributeString名前空間宣言を書き込みます。The following example uses the WriteAttributeString method to write a namespace declaration.

#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
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

注釈

このメソッドでは、ユーザー定義の名前空間プレフィックスを持つ属性を書き込み、指定した名前空間に関連付けます。This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. プレフィックスが"xmlns"である場合、このメソッドも名前空間宣言として扱われます、URI を指定した属性の値で指定する名前空間宣言済みのプレフィックスに関連付けます。If the prefix is "xmlns" then this method also treats this as a namespace declaration and associates the declared prefix with the namespace URI provided in the given attribute value. この場合、ns引数を指定できますnullします。In this case the ns argument can be null.

WriteAttributeString では次の処理が行われます。WriteAttributeString does the following:

  • 属性値には、二重引用符または単一引用符が含まれている場合に置き換えられます&quot;&apos;それぞれします。If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • 書き込む場合、xml:space属性値が有効では、属性、ライターを確認します。If writing an xml:space attribute, the writer verifies the attribute value is valid. (有効な値はpreserveまたはdefault)。(Valid values are preserve or default.)

  • 書き込む場合、xml:lang属性、ライターは検証されません属性値が w3c 勧告 『 XML 1.0 勧告有効であります。If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

このメソッドの非同期バージョンを参照してください。WriteAttributeStringAsyncします。For the asynchronous version of this method, see WriteAttributeStringAsync.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

派生クラスでオーバーライドされると、指定したローカル名と値の属性を書き込みます。When overridden in a derived class, writes out the attribute with the specified local name and value.

public:
 void WriteAttributeString(System::String ^ localName, System::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 String String String

属性のローカル名。The local name of the attribute.

value
String String String String

属性の値。The value of the attribute.

例外

ライターが WriteState.Element の状態にないか、またはライターが閉じています。The state of writer is not WriteState.Element or writer is closed.

または-or-

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

xml:space 属性値または xml:lang 属性値が無効です。The xml:space or xml:lang attribute value is invalid.

次の例は、本を書き込みます。The following example writes out a book.

#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
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 'Main 
End Class 'Sample

注釈

WriteAttributeString では次の処理が行われます。WriteAttributeString does the following:

  • 属性値には、二重引用符または単一引用符が含まれている場合に置き換えられます&quot;&apos;それぞれします。If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • 書き込む場合、xml:space属性値が有効では、属性、ライターを確認します。If writing an xml:space attribute, the writer verifies the attribute value is valid. (有効な値はpreserveまたはdefault)。(Valid values are preserve or default.)

  • 書き込む場合、xml:lang属性、ライターは検証されません属性値が w3c 勧告 『 XML 1.0 勧告有効であります。If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

このメソッドの非同期バージョンを参照してください。WriteAttributeStringAsyncします。For the asynchronous version of this method, see WriteAttributeStringAsync.

適用対象