XmlWriter.WriteValue 方法

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)

參數

例外狀況

備註

這個方法會採用 common language runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

備註

這個方法會使用 common language runtime (CLR) 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime (CLR) object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

如果 CLR 物件是清單類型 IEnumerable ，例如、 IList 或 ICollection ，則會將它視為實值型別的陣列。If the CLR object is a list type such as IEnumerable, IList, or ICollection, it is treated as an array of the value type. XmlWriter會根據 XML 架構 (XSD) 資料類型規則，將值轉換成其字串表示，並使用方法將其寫出 WriteString 。The XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

備註

這個方法會採用 common language runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

備註

這個方法會採用 common language runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

範例

下列範例會使用具類型的資料來寫入書籍節點。The following example writes a book node using typed data.

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) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

備註

這個方法會採用 common language runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請使用 WriteStringAsync 方法。For asynchronous operations, use the WriteStringAsync method.

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)

參數

例外狀況

備註

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

範例

下列範例會使用具類型的資料來寫入書籍節點。The following example writes a book node using typed data.

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) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

備註

這個方法會採用 common language runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

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)

參數

例外狀況

備註

這個方法會採用 common language runtime 物件，並使用 XML 架構定義語言 (XSD) 資料類型轉換規則，將輸入值轉換為所需的輸出類型。This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

呼叫 WriteValue 方法時，XmlWriter 會根據 XML 結構描述 (XSD) 資料型別規則將值轉換成其字串表示，並使用 WriteString 方法將其寫出。When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

如果連續多次呼叫 WriteValue，則不會使用空格分隔各個值。If WriteValue is called multiple times in succession, the values are not delimited by a space. 您必須在呼叫 WriteWhitespace 之間呼叫 WriteValue，以插入泛空白字元。You must call WriteWhitespace between calls to WriteValue to insert white space. 將陣列型別傳遞至多載 XmlWriter.WriteValue(Object) ，以寫出相異值的陣列。Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

如果在只輸出文字的實例上呼叫這個方法 XmlWriter ，則會將具類型的值序列化為文字。If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

若為非同步作業，請將這個方法的傳回值轉換成字串，然後使用 WriteStringAsync 方法。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.