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)

來源:: XmlWriter.cs

來源:: XmlWriter.cs

來源:: XmlWriter.cs

在衍生類別中覆寫時，寫出具有指定的前置詞、區域名稱、命名空間 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 產生關聯。在此情況下，自 ns 變數可以是 null 。

WriteAttributeString 會執行下列動作：

如果屬性值包含雙引號或單引號，則會分別取代為 " 和 ' 。
如果寫入 xml:space 屬性，寫入器會驗證屬性值有效。 (有效值為 preserve 或 default .)
如果寫入 xml:lang 屬性，寫入器不會根據 W3C XML 1.0 建議來驗證屬性值是否有效。

如需這個方法的非同步版本，請參閱 WriteAttributeStringAsync 。

適用於

WriteAttributeString(String, String, String)

來源:: XmlWriter.cs

來源:: XmlWriter.cs

來源:: XmlWriter.cs

在衍生類別中覆寫時，寫入具有指定區域名稱、命名空間 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

備註

這個方法會寫出具有使用者定義命名空間前置詞的屬性，並將它與指定的命名空間產生關聯。如果 localName 為「xmlns」，則這個方法也會將此視為命名空間宣告。在此情況下，自 ns 變數可以是 null 。

WriteAttributeString 會執行下列動作：

如果屬性值包含雙引號或單引號，則會分別取代為 " 和 ' 。
如果寫入 xml:space 屬性，寫入器會驗證屬性值有效。 (有效值為 preserve 或 default .)
如果寫入 xml:lang 屬性，寫入器不會根據 W3C XML 1.0 建議來驗證屬性值是否有效。

如需這個方法的非同步版本，請參閱 WriteAttributeStringAsync 。

適用於

WriteAttributeString(String, String)

來源:: XmlWriter.cs

來源:: XmlWriter.cs

來源:: XmlWriter.cs

在衍生類別中覆寫時，寫出具有指定的區域名稱與數值的屬性。

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)

參數

例外狀況

範例

備註

適用於

其他資源