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. 이렇게 하면 최소한의 구문 오버 헤드 간에 데이터를 전달할 때 사용 하 여 단순 형식 값을 파이프라인 하 XPathDocument, XmlReader, 및 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 개체가 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.

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이 throw됩니다.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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

예제

다음 예에서는 형식화 된 데이터를 사용 하 여 책 노드를 씁니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.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이 throw됩니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

예제

다음 예에서는 형식화 된 데이터를 사용 하 여 책 노드를 씁니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.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 개체를 목록 형식 인지와 같은 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 변환 값 XSD (XML 스키마) 데이터 형식에 따라 해당 문자열 표현으로 규칙 및 사용 하 여 씁니다는 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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이 throw됩니다.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는 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표시로 변환하고 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 텍스트 전용 형식화 된 값을 텍스트로 serialize 되는 출력 인스턴스.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.

적용 대상