XmlConvert XmlConvert XmlConvert XmlConvert Class

정의

XML 이름을 인코딩 및 디코딩하고 공용 언어 런타임 형식과 XSD(XML 스키마 정의) 언어 형식 사이의 변환 메서드를 제공합니다.Encodes and decodes XML names, and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. 데이터 형식을 변환할 때 반환되는 값은 로캘과 무관합니다.When converting data types, the values returned are locale-independent.

public ref class XmlConvert
public class XmlConvert
type XmlConvert = class
Public Class XmlConvert
상속
XmlConvertXmlConvertXmlConvertXmlConvert

설명

합니다 XmlConvert 클래스는 기능적으로 Convert 하지만 XML 표준을 지원 합니다.The XmlConvert class is functionally equivalent to the Convert class, but it supports XML standards. 이 형식 시스템은 XSD(XML 스키마 정의 언어) 스키마 형식을 기반으로 하며 반환되는 값은 항상 로캘과 무관합니다.The type system is based on the XML Schema definition language (XSD) schema type, and the values returned are always locale-independent.

인코딩 및 디코딩Encoding and decoding

요소 및 특성 이름이 나 ID 값은 W3C에 따라 XML 문자로 제한 XML 1.0 권장 사항합니다.Element and attribute names or ID values are limited to a range of XML characters according to the W3C XML 1.0 recommendation. 이름에 잘못 된 문자가 포함 하는 경우 사용할 수 있습니다 합니다 EncodeNameDecodeName 유효한 XML 이름으로 변환할이 클래스의 메서드.When names contain invalid characters, you can use the EncodeName and DecodeName methods in this class to translate them into valid XML names.

예를 들어 "Order Detail" 데이터베이스에서 머리글 열을 사용 하려는 경우 데이터베이스에 두 개의 단어 사이의 공백을 수 있습니다.For example, if you want to use the column heading "Order Detail" in a database, the database allows the space between the two words. 그러나 XML "Order"와 "세부 정보" 사이의 간격을 잘못 된 XML 문자로 간주 됩니다.However, in XML, the space between "Order" and "Detail" is considered an invalid XML character. 이스케이프 된 16 진수 인코딩을로 변환 하 고 나중에 디코딩할 해야 합니다.You have to convert it into an escaped hexadecimal encoding and decode it later.

사용할 수는 EncodeName 메서드를 XmlWriter 클래스에 쓰고 이름은 유효한 XML 이름입니다.You can use the EncodeName method with the XmlWriter class to ensure the names being written are valid XML names. 다음 C# 코드는 유효한 XML 이름에 "Order Detail" 이름 변환 하 고 요소를 씁니다 <Order_0x0020_Detail>My order</Order_0x0020_Detail>합니다.The following C# code converts the name "Order Detail" into a valid XML name and writes the element <Order_0x0020_Detail>My order</Order_0x0020_Detail>.

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

다음 XmlConvert 메서드는 인코딩 및 디코딩을 수행 합니다.The following XmlConvert methods perform encoding and decoding.

메서드Method 설명Description
EncodeName 이름을 사용 하 고 모든 잘못 된 문자가 이스케이프 문자열로 대체 되는 인코딩된 이름을 반환 합니다.Takes a name and returns the encoded name along with any invalid character that is replaced by an escape string. 이 메서드를 사용 하면 이름의 있을 즉 W3C에 따라 유효 하지 않게에서는 모든 위치에 콜론 XML 1.0 권장 사항의 네임 스페이스합니다.This method allows colons in any position, which means that the name may still be invalid according to the W3C Namespaces in XML 1.0 recommendation.
EncodeNmToken 이름을 사용 하 고 인코딩된 이름을 반환 합니다.Takes a name and returns the encoded name.
EncodeLocalName 동일 EncodeName 도 콜론 문자를 인코딩합니다를 제외 하 고 이름으로 사용할 수 있도록 보장 합니다 LocalName 네임 스페이스의 정규화 된 이름의 일부입니다.Same as EncodeName except that it also encodes the colon character, guaranteeing that the name can be used as the LocalName part of a namespace-qualified name.
DecodeName 모든 인코딩 메서드의 변형을 역으로 수행합니다.Reverses the transformation for all the encoding methods.

이름 유효성 검사Name validation

합니다 XmlConvert 클래스는 두 개의 메서드가 요소 또는 특성 이름에 문자를 확인 하 고 이름을 W3C 규칙을 따르는지 확인할 XML 1.0 권장 사항:The XmlConvert class contains two methods that check the characters in an element or attribute name and verify that the name conforms to the rules set by the W3C XML 1.0 recommendation:

  • VerifyName 문자를 검사 하 고 이름이 유효한 지 확인 합니다.VerifyName checks the characters and verifies that the name is valid. 메서드는 잘못 되 고 있지 않으면 예외를 throw 하는 경우 이름을 반환 합니다.The method returns the name if it's valid, and throws an exception if it isn't.

  • VerifyNCName 동일한 유효성 검사를 수행 하지만 비 정규화 된 이름을 허용 합니다.VerifyNCName performs the same validation, but accepts non-qualified names.

XmlConvert 토큰, 공백, 공용 Id 및 다른 문자열의 유효성을 검사 하는 추가 메서드를 포함 합니다.The XmlConvert contains additional methods that validate tokens, white-space characters, public IDs, and other strings.

데이터 형식 변환Data type conversion

XmlConvert 또한 문자열에서 데이터를 강력한 형식의 데이터 형식으로 변환할 수 있는 메서드를 제공 합니다.XmlConvert also provides methods that enable you to convert data from a string to a strongly typed data type. 예를 들어 합니다 ToDateTime 메서드를 문자열로 변환 해당 DateTime 해당 합니다.For example, the ToDateTime method converts a string to its DateTime equivalent. 유용 하므로에서 대부분의 메서드는 XmlReader 문자열로 반환 데이터 클래스입니다.This is useful because most methods in the XmlReader class return data as a string. 데이터를 읽은 다음 사용 되기 전에 적절 한 데이터 형식으로 변환 수 있습니다.After the data is read, it can be converted to the proper data type before being used. ToString 오버 로드는 강력한 형식의 데이터를 문자열로 변환 하 여 보완 작업을 제공 합니다.The ToString overloads provide the complementary operation by converting strongly typed data to strings. 예를 들어, 이것이 유용한 웹 페이지의 입력란에 데이터를 추가 하려는 경우입니다.For example, this is useful when you want to add the data to text boxes on a webpage. 로캘 설정은 고려 되지 계정 데이터 변환 중입니다.Locale settings are not taken into account during data conversion. 데이터 형식이 XML 스키마 (XSD) 데이터 형식을 기반으로 합니다.The data types are based on the XML Schema (XSD) data types.

생성자

XmlConvert() XmlConvert() XmlConvert() XmlConvert()

XmlConvert 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the XmlConvert class.

메서드

DecodeName(String) DecodeName(String) DecodeName(String) DecodeName(String)

이름을 디코딩합니다.Decodes a name. 이 메서드는 EncodeName(String) 메서드와 EncodeLocalName(String) 메서드와 반대로 수행합니다.This method does the reverse of the EncodeName(String) and EncodeLocalName(String) methods.

EncodeLocalName(String) EncodeLocalName(String) EncodeLocalName(String) EncodeLocalName(String)

이름을 올바른 XML 로컬 이름으로 변환합니다.Converts the name to a valid XML local name.

EncodeName(String) EncodeName(String) EncodeName(String) EncodeName(String)

이름을 올바른 XML 이름으로 변환합니다.Converts the name to a valid XML name.

EncodeNmToken(String) EncodeNmToken(String) EncodeNmToken(String) EncodeNmToken(String)

XML 사양에 따라 올바른 이름인지 확인합니다.Verifies the name is valid according to the XML specification.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
IsNCNameChar(Char) IsNCNameChar(Char) IsNCNameChar(Char) IsNCNameChar(Char)

전달된 문자가 콜론이 아닌 올바른 문자 형식인지 확인합니다.Checks whether the passed-in character is a valid non-colon character type.

IsPublicIdChar(Char) IsPublicIdChar(Char) IsPublicIdChar(Char) IsPublicIdChar(Char)

인수에 있는 문자가 올바른 공용 ID 문자이면 전달된 문자 인스턴스를 반환하고, 그렇지 않으면 null을 반환합니다.Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise null.

IsStartNCNameChar(Char) IsStartNCNameChar(Char) IsStartNCNameChar(Char) IsStartNCNameChar(Char)

전달된 문자가 올바른 시작 이름 문자 형식인지 확인합니다.Checks if the passed-in character is a valid Start Name Character type.

IsWhitespaceChar(Char) IsWhitespaceChar(Char) IsWhitespaceChar(Char) IsWhitespaceChar(Char)

전달된 문자가 올바른 XML 공백 문자인지 확인합니다.Checks if the passed-in character is a valid XML whitespace character.

IsXmlChar(Char) IsXmlChar(Char) IsXmlChar(Char) IsXmlChar(Char)

전달된 문자가 올바른 XML 문자인지 확인합니다.Checks if the passed-in character is a valid XML character.

IsXmlSurrogatePair(Char, Char) IsXmlSurrogatePair(Char, Char) IsXmlSurrogatePair(Char, Char) IsXmlSurrogatePair(Char, Char)

전달된 서로게이트 문자 쌍이 올바른 XML 문자인지 확인합니다.Checks if the passed-in surrogate pair of characters is a valid XML character.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToBoolean(String) ToBoolean(String) ToBoolean(String) ToBoolean(String)

String을 해당하는 Boolean 값으로 변환합니다.Converts the String to a Boolean equivalent.

ToByte(String) ToByte(String) ToByte(String) ToByte(String)

String을 해당하는 Byte 값으로 변환합니다.Converts the String to a Byte equivalent.

ToChar(String) ToChar(String) ToChar(String) ToChar(String)

String을 해당하는 Char 값으로 변환합니다.Converts the String to a Char equivalent.

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

String을 해당하는 DateTime 값으로 변환합니다.Converts the String to a DateTime equivalent.

ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String)

String을 해당하는 DateTime 값으로 변환합니다.Converts the String to a DateTime equivalent.

ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[])

String을 해당하는 DateTime 값으로 변환합니다.Converts the String to a DateTime equivalent.

ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode)

지정된 String를 사용하여 DateTimeXmlDateTimeSerializationMode으로 변환합니다.Converts the String to a DateTime using the XmlDateTimeSerializationMode specified.

ToDateTimeOffset(String) ToDateTimeOffset(String) ToDateTimeOffset(String) ToDateTimeOffset(String)

제공된 String을 해당 DateTimeOffset으로 변환합니다.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String) ToDateTimeOffset(String, String) ToDateTimeOffset(String, String) ToDateTimeOffset(String, String)

제공된 String을 해당 DateTimeOffset으로 변환합니다.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String[]) ToDateTimeOffset(String, String[]) ToDateTimeOffset(String, String[]) ToDateTimeOffset(String, String[])

제공된 String을 해당 DateTimeOffset으로 변환합니다.Converts the supplied String to a DateTimeOffset equivalent.

ToDecimal(String) ToDecimal(String) ToDecimal(String) ToDecimal(String)

String을 해당하는 Decimal 값으로 변환합니다.Converts the String to a Decimal equivalent.

ToDouble(String) ToDouble(String) ToDouble(String) ToDouble(String)

String을 해당하는 Double 값으로 변환합니다.Converts the String to a Double equivalent.

ToGuid(String) ToGuid(String) ToGuid(String) ToGuid(String)

String을 해당하는 Guid 값으로 변환합니다.Converts the String to a Guid equivalent.

ToInt16(String) ToInt16(String) ToInt16(String) ToInt16(String)

String을 해당하는 Int16 값으로 변환합니다.Converts the String to a Int16 equivalent.

ToInt32(String) ToInt32(String) ToInt32(String) ToInt32(String)

String을 해당하는 Int32 값으로 변환합니다.Converts the String to a Int32 equivalent.

ToInt64(String) ToInt64(String) ToInt64(String) ToInt64(String)

String을 해당하는 Int64 값으로 변환합니다.Converts the String to a Int64 equivalent.

ToSByte(String) ToSByte(String) ToSByte(String) ToSByte(String)

String을 해당하는 SByte 값으로 변환합니다.Converts the String to a SByte equivalent.

ToSingle(String) ToSingle(String) ToSingle(String) ToSingle(String)

String을 해당하는 Single 값으로 변환합니다.Converts the String to a Single equivalent.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
ToString(Boolean) ToString(Boolean) ToString(Boolean) ToString(Boolean)

BooleanString으로 변환합니다.Converts the Boolean to a String.

ToString(Byte) ToString(Byte) ToString(Byte) ToString(Byte)

ByteString으로 변환합니다.Converts the Byte to a String.

ToString(Char) ToString(Char) ToString(Char) ToString(Char)

CharString으로 변환합니다.Converts the Char to a String.

ToString(DateTime) ToString(DateTime) ToString(DateTime) ToString(DateTime)

DateTimeString으로 변환합니다.Converts the DateTime to a String.

ToString(DateTime, String) ToString(DateTime, String) ToString(DateTime, String) ToString(DateTime, String)

DateTimeString으로 변환합니다.Converts the DateTime to a String.

ToString(DateTime, XmlDateTimeSerializationMode) ToString(DateTime, XmlDateTimeSerializationMode) ToString(DateTime, XmlDateTimeSerializationMode) ToString(DateTime, XmlDateTimeSerializationMode)

지정된 DateTime를 사용하여 StringXmlDateTimeSerializationMode으로 변환합니다.Converts the DateTime to a String using the XmlDateTimeSerializationMode specified.

ToString(DateTimeOffset) ToString(DateTimeOffset) ToString(DateTimeOffset) ToString(DateTimeOffset)

제공된 DateTimeOffsetString으로 변환합니다.Converts the supplied DateTimeOffset to a String.

ToString(DateTimeOffset, String) ToString(DateTimeOffset, String) ToString(DateTimeOffset, String) ToString(DateTimeOffset, String)

제공된 DateTimeOffset을 지정된 형식의 String으로 변환합니다.Converts the supplied DateTimeOffset to a String in the specified format.

ToString(Decimal) ToString(Decimal) ToString(Decimal) ToString(Decimal)

DecimalString으로 변환합니다.Converts the Decimal to a String.

ToString(Double) ToString(Double) ToString(Double) ToString(Double)

DoubleString으로 변환합니다.Converts the Double to a String.

ToString(Guid) ToString(Guid) ToString(Guid) ToString(Guid)

GuidString으로 변환합니다.Converts the Guid to a String.

ToString(Int16) ToString(Int16) ToString(Int16) ToString(Int16)

Int16String으로 변환합니다.Converts the Int16 to a String.

ToString(Int32) ToString(Int32) ToString(Int32) ToString(Int32)

Int32String으로 변환합니다.Converts the Int32 to a String.

ToString(Int64) ToString(Int64) ToString(Int64) ToString(Int64)

Int64String으로 변환합니다.Converts the Int64 to a String.

ToString(SByte) ToString(SByte) ToString(SByte) ToString(SByte)

SByteString으로 변환합니다.Converts the SByte to a String.

ToString(Single) ToString(Single) ToString(Single) ToString(Single)

SingleString으로 변환합니다.Converts the Single to a String.

ToString(TimeSpan) ToString(TimeSpan) ToString(TimeSpan) ToString(TimeSpan)

TimeSpanString으로 변환합니다.Converts the TimeSpan to a String.

ToString(UInt16) ToString(UInt16) ToString(UInt16) ToString(UInt16)

UInt16String으로 변환합니다.Converts the UInt16 to a String.

ToString(UInt32) ToString(UInt32) ToString(UInt32) ToString(UInt32)

UInt32String으로 변환합니다.Converts the UInt32 to a String.

ToString(UInt64) ToString(UInt64) ToString(UInt64) ToString(UInt64)

UInt64String으로 변환합니다.Converts the UInt64 to a String.

ToTimeSpan(String) ToTimeSpan(String) ToTimeSpan(String) ToTimeSpan(String)

String을 해당하는 TimeSpan 값으로 변환합니다.Converts the String to a TimeSpan equivalent.

ToUInt16(String) ToUInt16(String) ToUInt16(String) ToUInt16(String)

String을 해당하는 UInt16 값으로 변환합니다.Converts the String to a UInt16 equivalent.

ToUInt32(String) ToUInt32(String) ToUInt32(String) ToUInt32(String)

String을 해당하는 UInt32 값으로 변환합니다.Converts the String to a UInt32 equivalent.

ToUInt64(String) ToUInt64(String) ToUInt64(String) ToUInt64(String)

String을 해당하는 UInt64 값으로 변환합니다.Converts the String to a UInt64 equivalent.

VerifyName(String) VerifyName(String) VerifyName(String) VerifyName(String)

해당 이름이 W3C Extended Markup Language 권장 사항에 따라 올바른 이름인지 확인합니다.Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.

VerifyNCName(String) VerifyNCName(String) VerifyNCName(String) VerifyNCName(String)

이름이 W3C Extended Markup Language 권장 사항에 따라 올바른 NCName인지 확인합니다.Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. NCName은 콜론이 포함될 수 없는 이름입니다.An NCName is a name that cannot contain a colon.

VerifyNMTOKEN(String) VerifyNMTOKEN(String) VerifyNMTOKEN(String) VerifyNMTOKEN(String)

W3C XML Schema Part2를 기준으로 문자열이 올바른 NMTOKEN인지 확인합니다. Datatypes 권장 사항을 참조하세요.Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyPublicId(String) VerifyPublicId(String) VerifyPublicId(String) VerifyPublicId(String)

문자열 인수에 있는 모든 문자가 올바른 공용 ID 문자이면 전달된 문자열 인스턴스를 반환합니다.Returns the passed in string instance if all the characters in the string argument are valid public id characters.

VerifyTOKEN(String) VerifyTOKEN(String) VerifyTOKEN(String) VerifyTOKEN(String)

W3C XML Schema Part2를 기준으로 문자열이 올바른 토큰인지 확인합니다. Datatypes 권장 사항을 참조하세요.Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyWhitespace(String) VerifyWhitespace(String) VerifyWhitespace(String) VerifyWhitespace(String)

문자열 인수에 있는 모든 문자가 올바른 공백 문자이면 전달된 문자열 인스턴스를 반환합니다.Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.

VerifyXmlChars(String) VerifyXmlChars(String) VerifyXmlChars(String) VerifyXmlChars(String)

문자열 인수의 모든 문자와 서로게이트 쌍 문자가 올바른 XML 문자인 경우 전달된 문자열을 반환하고 그렇지 않으면 첫 번째 잘못된 문자에 대한 정보로 XmlException을 throw합니다.Returns the passed-in string if all the characters and surrogate pair characters in the string argument are valid XML characters, otherwise an XmlException is thrown with information on the first invalid character encountered.

적용 대상