XmlConvert XmlConvert XmlConvert XmlConvert Class

定義

XML 名をエンコードおよびデコードし、共通言語ランタイム型と XML スキーマ定義言語 (XSD) 型との間で変換を実行するメソッドを提供します。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. 型システムは XML スキーマ定義言語 (XSD) のスキーマ型に基づいており、常にロケールに依存しない値が返されます。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"を使用する場合、データベースは、2 つの単語間のスペースを許可します。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 無効である任意の場所にコロンNamespaces in 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 で設定されている規則に準拠していることを確認し、要素または属性名に文字を 2 つのメソッドが含まれています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. 有効でない場合は、例外をスローする場合は、名前を返します。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. たとえば、これは便利な web ページ上のテキスト ボックスに、データを追加する場合です。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)

引数の文字が有効な公開識別子の文字の場合は渡された文字インスタンスを返し、それ以外の場合は 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)

渡された文字が有効な Start Name Character 型かどうかをチェックします。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)

指定された XmlDateTimeSerializationMode を使用して、StringDateTime に変換します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)

指定された XmlDateTimeSerializationMode を使用して、DateTimeString に変換します。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 Part 2: Datatypes』に照らし合わせて、文字列が有効な NMTOKEN であることを検証します。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)

文字列引数のすべての文字が有効な公開識別子の文字の場合、渡された文字列インスタンスを返します。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 Part 2: 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 がスローされます。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.

適用対象