XmlWriter.WriteValue 메서드

참조

정의

네임스페이스:: System.Xml

어셈블리:: System.Xml.ReaderWriter.dll

어셈블리:: System.Xml.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

단순 형식의 단일 값을 작성합니다.

오버로드

WriteValue(Single)	단정밀도 부동 소수점 숫자를 씁니다.
WriteValue(Object)	개체 값을 씁니다.
WriteValue(Int64)	Int64 값을 작성합니다.
WriteValue(Int32)	Int32 값을 작성합니다.
WriteValue(Double)	Double 값을 작성합니다.
WriteValue(String)	String 값을 작성합니다.
WriteValue(DateTimeOffset)	DateTimeOffset 값을 작성합니다.
WriteValue(DateTime)	DateTime 값을 작성합니다.
WriteValue(Boolean)	Boolean 값을 작성합니다.
WriteValue(Decimal)	Decimal 값을 작성합니다.

설명

이 메서드는 WriteValue CLR(공용 언어 런타임) 단순 형식 값을 허용하고 XSD(XML 스키마 정의 언어) 데이터 형식 변환 규칙에 따라 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다. 이렇게 하면 개체 간에 XPathDocument XmlReader XmlWriter 데이터를 전달할 때 최소한의 재 구문 분석 오버헤드로 단순 형식 값을 파이프라인할 수 있습니다. 이 기능은 CLR 단순 형식 및 인스턴스를 처리할 XmlWriter 때도 유용합니다. 작성하기 전에 클래스의 메서드 XmlConvert 를 사용하여 형식화된 데이터를 문자열 값으로 변환하는 대신 메서드를 호출 WriteValue 하여 형식화된 값을 작성할 수 있습니다.

비동기 작업의 경우 반환 값을 WriteValue 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

다음 표에서는 CLR 형식에 해당하는 기본 XSD 데이터 형식을 보여 줍니다.

CLR 개체가 목록 형식(예: IEnumerable) IList또는 ICollection값 형식의 배열로 처리되는 경우

CLR 유형	기본 XSD 데이터 형식
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte 배열	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd:decimal
System.Double	xsd:double
System.Int16**	xsd:integer
System.Int32	xsd:integer
System.Int64	xsd:integer
System.Single	xsd:float
System.String	xsd:string
System.IO.TextReader	xsd:string
System.IO.BinaryReader	xsd:base64Binary

**이러한 형식은 CLS 규격이 아닙니다. 해당 WriteValue 메서드가 없습니다.

연속해서 여러 번 호출되는 경우 WriteValue 값은 공백으로 구분되지 않습니다. 공백을 삽입하려면 WriteValue 호출 간에 호출 WriteWhitespace 해야 합니다.

WriteValue(Single)

단정밀도 부동 소수점 숫자를 씁니다.

public:
 virtual void WriteValue(float value);

public virtual void WriteValue (float value);

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

Public Overridable Sub WriteValue (value As Single)

매개 변수

value: Single

쓸 단정밀도 부동 소수점 숫자입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

설명

이 메서드는 공용 언어 런타임 개체를 사용하고 XSD(XML 스키마 정의 언어) 데이터 형식 변환 규칙을 사용하여 입력 값을 원하는 출력 형식으로 변환합니다.

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

연속해서 여러 번 호출되는 경우 WriteValue 값은 공백으로 구분되지 않습니다. 공백을 삽입하려면 WriteValue 호출 간에 호출 WriteWhitespace 해야 합니다. 배열 형식을 오버로드에 XmlWriter.WriteValue(Object) 전달하여 고유 값의 배열을 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(Object)

개체 값을 씁니다.

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

public virtual void WriteValue (object value);

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

Public Overridable Sub WriteValue (value As Object)

매개 변수

value: Object

쓸 개체 값입니다.

참고 .NET Framework 3.5 릴리스에서 이 메서드는 DateTimeOffset을 매개 변수로 받습니다.

예외

ArgumentException

잘못된 값이 지정된 경우

ArgumentNullException

value이 null인 경우

InvalidOperationException

작성기가 닫혀 있거나 오류가 발생한 경우

또는

설명

이 메서드는 CLR(공용 언어 런타임) 개체를 사용하고 XSD(XML 스키마 정의 언어) 데이터 형식 변환 규칙을 사용하여 입력 값을 원하는 출력 형식으로 변환합니다.

CLR 개체가 목록 형식(예: IEnumerable) IList또는 ICollection값 형식의 배열로 처리되는 경우 XSD XmlWriter (XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 씁니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(Int64)

Int64 값을 작성합니다.

public:
 virtual void WriteValue(long value);

public virtual void WriteValue (long value);

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

Public Overridable Sub WriteValue (value As Long)

매개 변수

value: Int64

쓸 Int64 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

설명

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(Int32)

Int32 값을 작성합니다.

public:
 virtual void WriteValue(int value);

public virtual void WriteValue (int value);

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

Public Overridable Sub WriteValue (value As Integer)

매개 변수

value: Int32

쓸 Int32 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

설명

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(Double)

Double 값을 작성합니다.

public:
 virtual void WriteValue(double value);

public virtual void WriteValue (double value);

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

Public Overridable Sub WriteValue (value As Double)

매개 변수

value: Double

쓸 Double 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

예제

다음 예제에서는 형식화된 데이터를 사용하여 책 노드를 씁니다.

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

설명

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(String)

String 값을 작성합니다.

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

public virtual void WriteValue (string value);

public virtual void WriteValue (string? value);

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

Public Overridable Sub WriteValue (value As String)

매개 변수

value: String

쓸 String 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

설명

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(DateTimeOffset)

DateTimeOffset 값을 작성합니다.

public:
 virtual void WriteValue(DateTimeOffset value);

public virtual void WriteValue (DateTimeOffset value);

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

Public Overridable Sub WriteValue (value As DateTimeOffset)

매개 변수

value: DateTimeOffset

쓸 DateTimeOffset 값입니다.

예외

InvalidOperationException

설명

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(DateTime)

DateTime 값을 작성합니다.

public:
 virtual void WriteValue(DateTime value);

public virtual void WriteValue (DateTime value);

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

Public Overridable Sub WriteValue (value As DateTime)

매개 변수

value: DateTime

쓸 DateTime 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

예제

다음 예제에서는 형식화된 데이터를 사용하여 책 노드를 씁니다.

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

설명

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(Boolean)

Boolean 값을 작성합니다.

public:
 virtual void WriteValue(bool value);

public virtual void WriteValue (bool value);

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

Public Overridable Sub WriteValue (value As Boolean)

매개 변수

value: Boolean

쓸 Boolean 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

설명

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

WriteValue(Decimal)

Decimal 값을 작성합니다.

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

public virtual void WriteValue (decimal value);

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

Public Overridable Sub WriteValue (value As Decimal)

매개 변수

value: Decimal

쓸 Decimal 값입니다.

예외

ArgumentException

잘못된 값이 지정된 경우

InvalidOperationException

설명

메서드가 WriteValue 호출 XmlWriter 되면 XSD(XML 스키마) 데이터 형식 규칙에 따라 값을 문자열 표현으로 변환하고 메서드를 사용하여 WriteString 작성합니다.

텍스트 전용을 출력하는 인스턴스에서 XmlWriter 이 메서드를 호출하면 형식화된 값이 텍스트로 직렬화됩니다.

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 WriteStringAsync 사용합니다.

적용 대상

다음을 통해 공유

XmlWriter.WriteValue 메서드

정의

오버로드

설명

WriteValue(Single)

매개 변수

예외

설명

적용 대상

WriteValue(Object)

매개 변수

예외

설명

적용 대상

WriteValue(Int64)

매개 변수

예외

설명

적용 대상

WriteValue(Int32)

매개 변수

예외

설명

적용 대상

WriteValue(Double)

매개 변수

예외

예제

설명

적용 대상

WriteValue(String)

매개 변수

예외

설명

적용 대상

WriteValue(DateTimeOffset)

매개 변수

예외

설명

적용 대상

WriteValue(DateTime)

매개 변수

예외

예제

설명

적용 대상

WriteValue(Boolean)

매개 변수

예외

설명

적용 대상

WriteValue(Decimal)

매개 변수

예외

설명

적용 대상

추가 리소스