XmlWriter.WriteValue XmlWriter.WriteValue XmlWriter.WriteValue XmlWriter.WriteValue Method

定義

単一の単純型の値を書き込みます。Writes a single simple-typed value.

オーバーロード

WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

String 値を書き込みます。Writes a String value.

WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Boolean 値を書き込みます。Writes a Boolean value.

WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

DateTime 値を書き込みます。Writes a DateTime value.

WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

DateTimeOffset 値を書き込みます。Writes a DateTimeOffset value.

WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Decimal 値を書き込みます。Writes a Decimal value.

WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Double 値を書き込みます。Writes a Double value.

WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Int32 値を書き込みます。Writes a Int32 value.

WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Int64 値を書き込みます。Writes a Int64 value.

WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

オブジェクト値を書き込みます。Writes the object value.

WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

単精度浮動小数点数を書き込みます。Writes a single-precision floating-point number.

注釈

WriteValueメソッドが共通言語ランタイム (CLR) 単純型の値を受け入れる、XML スキーマ定義言語 (XSD) データ型の変換の規則に従って文字列表現に変換およびを使用してそれらを書き込みます、 WriteStringメソッド。The WriteValue method accepts common language runtime (CLR) simple-typed values, converts them to their string representations according to the XML schema definition language (XSD) data type conversion rules, and writes them out by using the WriteString method. これにより、パイプラインの単純な型の値と最小再解析オーバーヘッドの間でデータを渡すときにXPathDocumentXmlReader、およびXmlWriterオブジェクト。This enables you to pipeline simple-type values with minimal reparsing overhead when passing data between XPathDocument, XmlReader, and XmlWriter objects. この機能は、CLR の単純型を扱うときにも役立ちますとXmlWriterインスタンス。This ability is also useful when dealing with CLR simple-types and an XmlWriter instance. 呼び出すことができます、WriteValue内のメソッドを使用する代わりに型指定された値を記述するメソッド、XmlConvert書き出す前に、文字列値に型指定されたデータを変換するクラス。You can call the WriteValue method to write the typed value instead of using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

非同期の操作の戻り値を変換WriteValue文字列を使用して、WriteStringAsyncメソッド。For asynchronous operations, convert the return value of WriteValue to a string and use the WriteStringAsync method.

次の表は、既定の CLR 型に対応する XSD データ型を示します。The following table shows the default XSD data types that correspond to CLR types.

CLR オブジェクトが IEnumerableIListICollection などのリスト型の場合は、値型の配列として扱われます。If the CLR object is a list type, such as IEnumerable, IList, or ICollection, it is treated as an array of the value type.

CLR 型CLR type 既定の XSD データ型Default XSD data type
System.Boolean xsd:booleanxsd:boolean
System.Byte** xsd:integerxsd:integer
System.Byte 配列System.Byte array xsd:base64Binaryxsd:base64Binary
System.Char** xsd:stringxsd:string
System.DateTime xsd:dateTimexsd:dateTime
System.Decimal xsd:decimalxsd:decimal
System.Double xsd:doublexsd:double
System.Int16** xsd:integerxsd:integer
System.Int32 xsd:integerxsd:integer
System.Int64 xsd:integerxsd:integer
System.Single xsd:floatxsd:float
System.String xsd:stringxsd:string
System.IO.TextReader xsd:stringxsd:string
System.IO.BinaryReader xsd:base64Binaryxsd:base64Binary

** これらの型は CLS 準拠ではありません。**These types are not CLS-compliant. 対応がないWriteValueメソッド。They do not have corresponding WriteValue methods.

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.

WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

String 値を書き込みます。Writes a String value.

public:
 virtual void WriteValue(System::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 String String

書き込む String 値。The String value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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 スキーマ定義言語 (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.

WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Boolean 値を書き込みます。Writes a Boolean value.

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

書き込む Boolean 値。The Boolean value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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 スキーマ定義言語 (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.

WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

DateTime 値を書き込みます。Writes a DateTime value.

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

書き込む DateTime 値。The DateTime value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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."

次の例では、型指定されたデータを使用して book ノードを書き込みます。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

注釈

このメソッドは、共通言語ランタイム オブジェクトを受け取り、入力値を 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.

WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

DateTimeOffset 値を書き込みます。Writes a DateTimeOffset value.

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)

パラメーター

例外

先行の非同期操作が完了する前に、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."

注釈

非同期操作は、このメソッドの戻り値を文字列に変換し、使用、WriteStringAsyncメソッド。For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Decimal 値を書き込みます。Writes a Decimal value.

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

書き込む Decimal 値。The Decimal value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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 スキーマ定義言語 (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.

WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Double 値を書き込みます。Writes a Double value.

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

書き込む Double 値。The Double value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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."

次の例では、型指定されたデータを使用して book ノードを書き込みます。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

注釈

このメソッドは、共通言語ランタイム オブジェクトを受け取り、入力値を 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.

WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Int32 値を書き込みます。Writes a Int32 value.

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

書き込む Int32 値。The Int32 value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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 スキーマ定義言語 (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.

WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Int64 値を書き込みます。Writes a Int64 value.

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

書き込む Int64 値。The Int64 value to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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 スキーマ定義言語 (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.

WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

オブジェクト値を書き込みます。Writes the object value.

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

書き込むオブジェクト値。The object value to write.

メモ .NET Framework 3.5 のリリースでは、このメソッドは DateTimeOffset をパラメーターとして受け入れます。Note With the release of the .NET Framework 3.5, this method accepts DateTimeOffset as a parameter.

例外

無効な値が指定されました。An invalid value was specified.

ライターが閉じているかエラー状態です。The writer is closed or in error state.

または-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."

注釈

このメソッドは、共通言語ランタイム (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 オブジェクトがリストの種類をなどがかどうかIEnumerableIList、または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.

WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

単精度浮動小数点数を書き込みます。Writes a single-precision floating-point number.

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

書き込む単精度浮動小数点数。The single-precision floating-point number to write.

例外

無効な値が指定されました。An invalid value was specified.

先行の非同期操作が完了する前に、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 スキーマ定義言語 (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.

適用対象