다음을 통해 공유


XmlWriter.WriteValue 메서드

정의

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

오버로드

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 작성합니다. 이렇게 하면 개체 간에 XPathDocumentXmlReaderXmlWriter 데이터를 전달할 때 최소한의 재 구문 분석 오버헤드로 단순 형식 값을 파이프라인할 수 있습니다. 이 기능은 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

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

예외

잘못된 값이 지정된 경우

이전 비동기 작업이 완료되기 전에 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을 매개 변수로 받습니다.

예외

잘못된 값이 지정된 경우

valuenull인 경우

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

또는

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

설명

이 메서드는 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 값입니다.

예외

잘못된 값이 지정된 경우

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

설명

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

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

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

텍스트 전용을 출력하는 인스턴스에서 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 값입니다.

예외

잘못된 값이 지정된 경우

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

설명

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

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

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

텍스트 전용을 출력하는 인스턴스에서 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 값입니다.

예외

잘못된 값이 지정된 경우

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

예제

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

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

설명

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

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

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

텍스트 전용을 출력하는 인스턴스에서 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 값입니다.

예외

잘못된 값이 지정된 경우

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

설명

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

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

텍스트 전용을 출력하는 인스턴스에서 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 값입니다.

예외

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

설명

비동기 작업의 경우 이 메서드의 반환 값을 문자열로 변환하고 메서드를 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 값입니다.

예외

잘못된 값이 지정된 경우

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

예제

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

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

설명

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

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

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

텍스트 전용을 출력하는 인스턴스에서 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 값입니다.

예외

잘못된 값이 지정된 경우

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

설명

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

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

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

텍스트 전용을 출력하는 인스턴스에서 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 값입니다.

예외

잘못된 값이 지정된 경우

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

설명

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

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

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

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

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

적용 대상