XmlWriter.WriteValue 方法

參考

定義

命名空間:: System.Xml

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

寫入單一簡單類型的值。

多載

WriteValue(Single)	寫入單精確度浮點數。
WriteValue(Object)	寫入物件值。
WriteValue(Int64)	寫入 Int64 值。
WriteValue(Int32)	寫入 Int32 值。
WriteValue(Double)	寫入 Double 值。
WriteValue(String)	寫入 String 值。
WriteValue(DateTimeOffset)	寫入 DateTimeOffset 值。
WriteValue(DateTime)	寫入 DateTime 值。
WriteValue(Boolean)	寫入 Boolean 值。
WriteValue(Decimal)	寫入 Decimal 值。

備註

方法 WriteValue 接受 Common Language Runtime (CLR) 簡單型別值、根據 XML 架構定義語言 (XSD) 資料類型轉換規則，將它們轉換成字串表示，並使用方法寫出 WriteString 它們。這可讓您在、 XmlReader 和 XmlWriter 物件之間 XPathDocument 傳遞資料時，以最少的重新分析額外負荷來管線簡單類型值。處理 CLR 簡單類型和 XmlWriter 實例時，這項功能也很有用。您可以呼叫 WriteValue 方法來寫入具型別值，而不是使用類別中的 XmlConvert 方法，在寫出之前，先將具型別的資料轉換成字串值。

針對非同步作業，請將的 WriteValue 傳回值轉換為字串，並使用 WriteStringAsync 方法。

下表顯示對應至 CLR 類型的預設 XSD 資料類型。

如果 CLR 物件是清單型別 (如 IEnumerable、IList 或 ICollection)，則會將其視為數值型別的陣列。

CLR 類型	預設 XSD 資料類型
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte 陣列	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd:decimal
System.Double	xsd:double
System.Int16**	xsd:integer
System.Int32	xsd:integer
System.Int64	xsd:integer
System.Single	xsd:float
System.String	xsd:string
System.IO.TextReader	xsd:string
System.IO.BinaryReader	xsd:base64Binary

**這些型別與 CLS 不相容。它們沒有對應的 WriteValue 方法。

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。

WriteValue(Single)

寫入單精確度浮點數。

public:
 virtual void WriteValue(float value);

public virtual void WriteValue (float value);

abstract member WriteValue : single -> unit
override this.WriteValue : single -> unit

Public Overridable Sub WriteValue (value As Single)

參數

value: Single

要寫入的單精確度浮點數。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。將陣列類型傳遞至多載， XmlWriter.WriteValue(Object) 以寫出相異值的陣列。

如果在輸出僅限文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

對於非同步作業，請將此方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(Object)

寫入物件值。

public:
 virtual void WriteValue(System::Object ^ value);

public virtual void WriteValue (object value);

abstract member WriteValue : obj -> unit
override this.WriteValue : obj -> unit

Public Overridable Sub WriteValue (value As Object)

參數

value: Object

要寫入的物件值。

附註：使用 .NET Framework 3.5 的版本時，這個方法會接受 DateTimeOffset 作為參數。

例外狀況

ArgumentException

指定了無效的值。

ArgumentNullException

value 為 null。

InvalidOperationException

寫入器的狀態為關閉或錯誤。

-或-

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime (CLR) 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

如果 CLR 物件是清單類型，例如 IEnumerable 、 IList 或 ICollection ，則會將它視為實值型別的陣列。會 XmlWriter 根據 XML 架構 (XSD) 資料類型規則，將值轉換成其字串表示，並使用方法將其寫出 WriteString 。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(Int64)

寫入 Int64 值。

public:
 virtual void WriteValue(long value);

public virtual void WriteValue (long value);

abstract member WriteValue : int64 -> unit
override this.WriteValue : int64 -> unit

Public Overridable Sub WriteValue (value As Long)

參數

value: Int64

要寫入的 Int64 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(Int32)

寫入 Int32 值。

public:
 virtual void WriteValue(int value);

public virtual void WriteValue (int value);

abstract member WriteValue : int -> unit
override this.WriteValue : int -> unit

Public Overridable Sub WriteValue (value As Integer)

參數

value: Int32

要寫入的 Int32 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(Double)

寫入 Double 值。

public:
 virtual void WriteValue(double value);

public virtual void WriteValue (double value);

abstract member WriteValue : double -> unit
override this.WriteValue : double -> unit

Public Overridable Sub WriteValue (value As Double)

參數

value: Double

要寫入的 Double 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

範例

下列範例會使用具型別的資料寫入書籍節點。

Double price = 9.95;
DateTime date = new DateTime(2004, 5, 20);

using (XmlWriter writer = XmlWriter.Create("data.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteStartAttribute("pub-date");
    writer.WriteValue(date);
    writer.WriteEndAttribute();

    writer.WriteStartElement("price");
    writer.WriteValue(price);
    writer.WriteEndElement();

    writer.WriteEndElement();
    writer.Flush();
}

Dim price As [Double] = 9.95
Dim [date] As New DateTime(2004, 5, 20)
        
Using writer As XmlWriter = XmlWriter.Create("data.xml")
  writer.WriteStartElement("book")
  writer.WriteStartAttribute("pub-date")
  writer.WriteValue([date])
  writer.WriteEndAttribute()
            
  writer.WriteStartElement("price")
  writer.WriteValue(price)
  writer.WriteEndElement()
            
  writer.WriteEndElement()
  writer.Flush()
End Using

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(String)

寫入 String 值。

public:
 virtual void WriteValue(System::String ^ value);

public virtual void WriteValue (string value);

public virtual void WriteValue (string? value);

abstract member WriteValue : string -> unit
override this.WriteValue : string -> unit

Public Overridable Sub WriteValue (value As String)

參數

value: String

要寫入的 String 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

如果在輸出僅限文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請使用 WriteStringAsync 方法。

適用於

WriteValue(DateTimeOffset)

寫入 DateTimeOffset 值。

public:
 virtual void WriteValue(DateTimeOffset value);

public virtual void WriteValue (DateTimeOffset value);

abstract member WriteValue : DateTimeOffset -> unit
override this.WriteValue : DateTimeOffset -> unit

Public Overridable Sub WriteValue (value As DateTimeOffset)

參數

value: DateTimeOffset

要寫入的 DateTimeOffset 值。

例外狀況

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(DateTime)

寫入 DateTime 值。

public:
 virtual void WriteValue(DateTime value);

public virtual void WriteValue (DateTime value);

abstract member WriteValue : DateTime -> unit
override this.WriteValue : DateTime -> unit

Public Overridable Sub WriteValue (value As DateTime)

參數

value: DateTime

要寫入的 DateTime 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

範例

下列範例會使用具型別的資料寫入書籍節點。

Double price = 9.95;
DateTime date = new DateTime(2004, 5, 20);

using (XmlWriter writer = XmlWriter.Create("data.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteStartAttribute("pub-date");
    writer.WriteValue(date);
    writer.WriteEndAttribute();

    writer.WriteStartElement("price");
    writer.WriteValue(price);
    writer.WriteEndElement();

    writer.WriteEndElement();
    writer.Flush();
}

Dim price As [Double] = 9.95
Dim [date] As New DateTime(2004, 5, 20)
        
Using writer As XmlWriter = XmlWriter.Create("data.xml")
  writer.WriteStartElement("book")
  writer.WriteStartAttribute("pub-date")
  writer.WriteValue([date])
  writer.WriteEndAttribute()
            
  writer.WriteStartElement("price")
  writer.WriteValue(price)
  writer.WriteEndElement()
            
  writer.WriteEndElement()
  writer.Flush()
End Using

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(Boolean)

寫入 Boolean 值。

public:
 virtual void WriteValue(bool value);

public virtual void WriteValue (bool value);

abstract member WriteValue : bool -> unit
override this.WriteValue : bool -> unit

Public Overridable Sub WriteValue (value As Boolean)

參數

value: Boolean

要寫入的 Boolean 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

WriteValue(Decimal)

寫入 Decimal 值。

public:
 virtual void WriteValue(System::Decimal value);

public virtual void WriteValue (decimal value);

abstract member WriteValue : decimal -> unit
override this.WriteValue : decimal -> unit

Public Overridable Sub WriteValue (value As Decimal)

參數

value: Decimal

要寫入的 Decimal 值。

例外狀況

ArgumentException

指定了無效的值。

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

此方法會採用 Common Language Runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換成所需的輸出類型。

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。

如果在輸出純文字的實例上 XmlWriter 呼叫這個方法，則具類型的值會序列化為文字。

針對非同步作業，請將這個方法的傳回值轉換為字串，並使用 WriteStringAsync 方法。

適用於

XmlWriter.WriteValue 方法

定義

多載

備註

WriteValue(Single)

參數

例外狀況

備註

適用於

WriteValue(Object)

參數

例外狀況

備註

適用於

WriteValue(Int64)

參數

例外狀況

備註

適用於

WriteValue(Int32)

參數

例外狀況

備註

適用於

WriteValue(Double)

參數

例外狀況

範例

備註

適用於

WriteValue(String)

參數

例外狀況

備註

適用於

WriteValue(DateTimeOffset)

參數

例外狀況

備註

適用於

WriteValue(DateTime)

參數

例外狀況

範例

備註

適用於

WriteValue(Boolean)

參數

例外狀況

備註

適用於

WriteValue(Decimal)

參數

例外狀況

備註

適用於

其他資源