XmlConvert 클래스

정의

XML 이름을 인코딩 및 디코딩하고 공용 언어 런타임 형식과 XSD(XML 스키마 정의 언어) 형식 간에 변환하는 메서드를 제공합니다. 데이터 형식을 변환할 때 반환되는 값은 로캘과 독립적입니다.

public ref class XmlConvert abstract sealed
public ref class XmlConvert
public static class XmlConvert
public class XmlConvert
type XmlConvert = class
Public Class XmlConvert
상속
XmlConvert

설명

클래스 XmlConvert 는 기능적으로 클래스와 Convert 동일하지만 XML 표준을 지원합니다. 형식 시스템은 XSD(XML 스키마 정의 언어) 스키마 형식을 기반으로 하며 반환되는 값은 항상 로캘 독립적입니다.

인코딩 및 디코딩

요소 및 특성 이름 또는 ID 값은 W3C XML 1.0 권장 사항에 따라 XML 문자 범위로 제한됩니다. 이름에 잘못된 문자가 포함된 경우 이 클래스의 EncodeName 메서드 및 DecodeName 메서드를 사용하여 유효한 XML 이름으로 변환할 수 있습니다.

예를 들어 데이터베이스에서 열 제목 "Order Detail"를 사용하려면 데이터베이스에서 두 단어 사이의 공간을 허용합니다. 그러나 XML에서는 "Order"와 "Detail" 사이의 공백이 잘못된 XML 문자로 간주됩니다. 이스케이프된 16진수 인코딩으로 변환하고 나중에 디코딩해야 합니다.

이 메서드를 EncodeName 클래스와 함께 XmlWriter 사용하여 작성되는 이름이 유효한 XML 이름인지 확인할 수 있습니다. 다음 C# 코드는 이름 "Order Detail"를 유효한 XML 이름으로 변환하고 요소를 <Order_0x0020_Detail>My order</Order_0x0020_Detail>씁니다.

writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");

다음 XmlConvert 메서드는 인코딩 및 디코딩을 수행합니다.

Method Description
EncodeName 이름을 입력 받아 인코딩된 이름과 함께 이스케이프 문자열로 대체된 잘못된 문자를 반환합니다. 이 메서드는 모든 위치에서 콜론을 허용합니다. 즉, XML 1.0 권장 사항의 W3C 네임스페이스에 따라 이름이 여전히 유효하지 않을 수 있습니다.
EncodeNmToken 이름을 받아 인코딩된 이름을 반환합니다.
EncodeLocalName EncodeName 콜론 문자도 인코딩한다는 점을 제외하면, 이름이 네임스페이스가 지정된 이름의 LocalName 부분으로 사용될 수 있음을 보장합니다.
DecodeName 모든 인코딩 메서드에 대한 변환을 반대로 바뀝니다.

이름 유효성 검사

클래스에는 XmlConvert 요소 또는 특성 이름의 문자를 확인하고 이름이 W3C XML 1.0 권장 사항에 의해 설정된 규칙을 준수하는지 확인하는 두 가지 메서드가 포함되어 있습니다.

  • VerifyName 는 문자를 확인하고 이름이 유효한지 확인합니다. 메서드는 유효한 경우 이름을 반환하고, 그렇지 않은 경우 예외를 throw합니다.
  • VerifyNCName 는 동일한 유효성 검사를 수행하지만 정규화되지 않은 이름을 허용합니다.

토큰 XmlConvert , 공백 문자, 공용 ID 및 기타 문자열의 유효성을 검사하는 추가 메서드가 포함되어 있습니다.

데이터 형식 변환

XmlConvert 또한 문자열에서 강력한 형식의 데이터 형식으로 데이터를 변환할 수 있는 메서드를 제공합니다. 예를 들어 메서드는 ToDateTime 문자열을 해당하는 문자열로 DateTime 변환합니다. 이것은 클래스의 대부분의 메서드가 데이터를 문자열로 반환하기 때문에 유용합니다. 데이터를 읽은 후에는 사용되기 전에 적절한 데이터 형식으로 변환할 수 있습니다. ToString 오버로드는 강력한 형식의 데이터를 문자열로 변환하여 보완 작업을 제공합니다. 예를 들어 웹 페이지의 텍스트 상자에 데이터를 추가하려는 경우에 유용합니다. 로캘 설정은 데이터 변환 중에 고려되지 않습니다. 데이터 형식은 XSD(XML 스키마) 데이터 형식을 기반으로 합니다.

생성자

Name Description
XmlConvert()

XmlConvert 클래스의 새 인스턴스를 초기화합니다.

메서드

Name Description
DecodeName(String)

이름을 디코딩합니다. 이 메서드는 메서드 및 EncodeName(String) 메서드의 역방향을 EncodeLocalName(String) 수행합니다.

EncodeLocalName(String)

이름을 유효한 XML 로컬 이름으로 변환합니다.

EncodeName(String)

이름을 유효한 XML 이름으로 변환합니다.

EncodeNmToken(String)

이름이 XML 사양에 따라 유효한지 확인합니다.

IsNCNameChar(Char)

전달된 문자가 유효한 비콜론 문자 형식인지 여부를 확인합니다.

IsPublicIdChar(Char)

인수의 문자가 유효한 공용 ID 문자이면 전달된 문자 인스턴스를 반환하고, 그렇지 않으면 null전달된 문자 인스턴스를 반환합니다.

IsStartNCNameChar(Char)

전달된 문자가 유효한 시작 이름 문자 형식인지 확인합니다.

IsWhitespaceChar(Char)

전달된 문자가 유효한 XML 공백 문자인지 확인합니다.

IsXmlChar(Char)

전달된 문자가 유효한 XML 문자인지 확인합니다.

IsXmlSurrogatePair(Char, Char)

전달된 서로게이트 문자 쌍이 유효한 XML 문자인지 확인합니다.

ToBoolean(String)

해당 값으로 String 변환합니다Boolean.

ToByte(String)

해당 값으로 String 변환합니다Byte.

ToChar(String)

해당 값으로 String 변환합니다Char.

ToDateTime(String, String)

해당 값으로 String 변환합니다DateTime.

ToDateTime(String, String[])

해당 값으로 String 변환합니다DateTime.

ToDateTime(String, XmlDateTimeSerializationMode)

String 지정된 using로 DateTimeXmlDateTimeSerializationMode 변환합니다.

ToDateTime(String)
사용되지 않음.
사용되지 않음.

해당 값으로 String 변환합니다DateTime.

ToDateTimeOffset(String, String)

제공된 String 값을 해당하는 값으로 DateTimeOffset 변환합니다.

ToDateTimeOffset(String, String[])

제공된 String 값을 해당하는 값으로 DateTimeOffset 변환합니다.

ToDateTimeOffset(String)

제공된 String 값을 해당하는 값으로 DateTimeOffset 변환합니다.

ToDecimal(String)

해당 값으로 String 변환합니다Decimal.

ToDouble(String)

해당 값으로 String 변환합니다Double.

ToGuid(String)

해당 값으로 String 변환합니다Guid.

ToInt16(String)

해당 값으로 String 변환합니다Int16.

ToInt32(String)

해당 값으로 String 변환합니다Int32.

ToInt64(String)

해당 값으로 String 변환합니다Int64.

ToSByte(String)

해당 값으로 String 변환합니다SByte.

ToSingle(String)

해당 값으로 String 변환합니다Single.

ToString(Boolean)

를 으로 Boolean변환합니다String.

ToString(Byte)

를 으로 Byte변환합니다String.

ToString(Char)

를 으로 Char변환합니다String.

ToString(DateTime, String)

를 으로 DateTime변환합니다String.

ToString(DateTime, XmlDateTimeSerializationMode)

DateTime 지정된 using로 StringXmlDateTimeSerializationMode 변환합니다.

ToString(DateTime)
사용되지 않음.
사용되지 않음.

를 으로 DateTime변환합니다String.

ToString(DateTimeOffset, String)

제공된 DateTimeOffset 형식을 지정된 형식으로 String 변환합니다.

ToString(DateTimeOffset)

제공 DateTimeOffsetString된 값을 .로 변환합니다.

ToString(Decimal)

를 으로 Decimal변환합니다String.

ToString(Double)

를 으로 Double변환합니다String.

ToString(Guid)

를 으로 Guid변환합니다String.

ToString(Int16)

를 으로 Int16변환합니다String.

ToString(Int32)

를 으로 Int32변환합니다String.

ToString(Int64)

를 으로 Int64변환합니다String.

ToString(SByte)

를 으로 SByte변환합니다String.

ToString(Single)

를 으로 Single변환합니다String.

ToString(TimeSpan)

를 으로 TimeSpan변환합니다String.

ToString(UInt16)

를 으로 UInt16변환합니다String.

ToString(UInt32)

를 으로 UInt32변환합니다String.

ToString(UInt64)

를 으로 UInt64변환합니다String.

ToTimeSpan(String)

해당 값으로 String 변환합니다TimeSpan.

ToUInt16(String)

해당 값으로 String 변환합니다UInt16.

ToUInt32(String)

해당 값으로 String 변환합니다UInt32.

ToUInt64(String)

해당 값으로 String 변환합니다UInt64.

VerifyName(String)

W3C 확장 태그 언어 권장 사항에 따라 이름이 유효한 이름인지 확인합니다.

VerifyNCName(String)

W3C 확장 태그 언어 권장 사항에 따라 이름이 유효한 NCName 지 확인합니다. 콜 NCName 론을 포함할 수 없는 이름입니다.

VerifyNMTOKEN(String)

W3C XML 스키마 파트2: Datatypes 권장 사항에 따라 문자열이 유효한 NMTOKEN인지 확인합니다.

VerifyPublicId(String)

문자열 인수의 모든 문자가 유효한 공용 ID 문자인 경우 전달된 문자열 인스턴스를 반환합니다.

VerifyTOKEN(String)

W3C XML 스키마 파트2: Datatypes 권장 사항에 따라 문자열이 유효한 토큰인지 확인합니다.

VerifyWhitespace(String)

문자열 인수의 모든 문자가 유효한 공백 문자인 경우 전달된 문자열 인스턴스를 반환합니다.

VerifyXmlChars(String)

문자열 인수의 모든 문자와 서로게이트 쌍 문자가 유효한 XML 문자이면 전달된 문자열을 반환하고, 그렇지 않으면 XmlException 발생한 첫 번째 잘못된 문자에 대한 정보를 사용하여 전달된 문자열을 반환합니다.

적용 대상