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出力します。b.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. これにより、、、およびXPathDocument XmlWriterの各オブジェクトの間でデータを渡すときに、 XmlReader単純型の値と再解析のオーバーヘッドを最小限にすることができます。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. XmlConvertクラスのメソッドをWriteValue使用して、型指定されたデータを書き出す前に文字列値に変換するのではなく、メソッドを呼び出して型指定された値を書き込むことができます。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.

適用対象