XmlConvert Classe

Definição

Codifica e decodifica nomes XML e fornece métodos para converter entre tipos Common Language Runtime e tipos XSD (linguagem de definição de esquema XML).Encodes and decodes XML names, and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. Ao converter tipos de dados, os valores retornados independem da localidade.When converting data types, the values returned are locale-independent.

public ref class XmlConvert abstract sealed
public ref class XmlConvert
public static class XmlConvert
public class XmlConvert
type XmlConvert = class
Public Class XmlConvert
Herança
XmlConvert

Comentários

A XmlConvert classe é funcionalmente equivalente à Convert classe, mas dá suporte a padrões XML.The XmlConvert class is functionally equivalent to the Convert class, but it supports XML standards. O sistema de tipos é baseado no tipo do idioma da definição de esquema XML (XSD), e os valores retornados são sempre são independentes.The type system is based on the XML Schema definition language (XSD) schema type, and the values returned are always locale-independent.

Codificação e decodificaçãoEncoding and decoding

Os nomes de elementos e atributos ou valores de ID são limitados a um intervalo de caracteres XML de acordo com a recomendação do W3C 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. Quando os nomes contêm caracteres inválidos, você pode usar os EncodeName DecodeName métodos e nessa classe para convertê-los em nomes XML válidos.When names contain invalid characters, you can use the EncodeName and DecodeName methods in this class to translate them into valid XML names.

Por exemplo, se você quiser usar o título de coluna "detalhes do pedido" em um banco de dados, o banco de dados permitirá o espaço entre as duas palavras.For example, if you want to use the column heading "Order Detail" in a database, the database allows the space between the two words. No entanto, em XML, o espaço entre "Order" e "Detail" é considerado um caractere XML inválido.However, in XML, the space between "Order" and "Detail" is considered an invalid XML character. Você precisa convertê-lo em uma codificação hexadecimal de escape e decodificá-lo mais tarde.You have to convert it into an escaped hexadecimal encoding and decode it later.

Você pode usar o EncodeName método com a XmlWriter classe para garantir que os nomes que estão sendo gravados sejam nomes XML válidos.You can use the EncodeName method with the XmlWriter class to ensure the names being written are valid XML names. O código C# a seguir converte o nome "detalhes do pedido" em um nome XML válido e grava o elemento <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");

Os métodos a seguir XmlConvert executam codificação e decodificação.The following XmlConvert methods perform encoding and decoding.

MétodoMethod DescriçãoDescription
EncodeName Usa um nome e retorna o nome codificado junto com qualquer caractere inválido que é substituído por uma cadeia de caracteres de escape.Takes a name and returns the encoded name along with any invalid character that is replaced by an escape string. Esse método permite dois-pontos em qualquer posição, o que significa que o nome ainda pode ser inválido de acordo com os namespaces W3C na recomendação do 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 Usa um nome e retorna o nome codificado.Takes a name and returns the encoded name.
EncodeLocalName Igual a, EncodeName exceto que ele também codifica o caractere de dois-pontos, garantindo que o nome possa ser usado como LocalName parte de um nome qualificado para namespace.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 Inverte a transformação para todos os métodos de codificação.Reverses the transformation for all the encoding methods.

Validação de nomeName validation

A XmlConvert classe contém dois métodos que verificam os caracteres em um nome de elemento ou atributo e verificam se o nome está de acordo com as regras definidas pela recomendação do 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 Verifica os caracteres e verifica se o nome é válido.VerifyName checks the characters and verifies that the name is valid. O método retornará o nome se ele for válido e lançará uma exceção se não for.The method returns the name if it's valid, and throws an exception if it isn't.

  • VerifyNCName executa a mesma validação, mas aceita nomes não qualificados.VerifyNCName performs the same validation, but accepts non-qualified names.

O XmlConvert contém métodos adicionais que validam tokens, caracteres de espaço em branco, IDs públicas e outras cadeias.The XmlConvert contains additional methods that validate tokens, white-space characters, public IDs, and other strings.

Conversão de tipo de dadosData type conversion

XmlConvert também fornece métodos que permitem converter dados de uma cadeia de caracteres em um tipo de dados fortemente tipado.XmlConvert also provides methods that enable you to convert data from a string to a strongly typed data type. Por exemplo, o ToDateTime método converte uma cadeia de caracteres em seu DateTime equivalente.For example, the ToDateTime method converts a string to its DateTime equivalent. Isso é útil porque a maioria dos métodos na XmlReader classe retorna dados como uma cadeia de caracteres.This is useful because most methods in the XmlReader class return data as a string. Depois que os dados são lidos, eles podem ser convertidos para o tipo de dados apropriado antes de serem usados.After the data is read, it can be converted to the proper data type before being used. As ToString sobrecargas fornecem a operação complementar convertendo dados fortemente tipados em cadeias de caracteres.The ToString overloads provide the complementary operation by converting strongly typed data to strings. Por exemplo, isso é útil quando você deseja adicionar os dados a caixas de texto em uma página da Web.For example, this is useful when you want to add the data to text boxes on a webpage. As configurações de localidade não são levadas em conta durante a conversão de dados.Locale settings are not taken into account during data conversion. Os tipos de dados são baseados nos tipos de dados XSD (esquema XML).The data types are based on the XML Schema (XSD) data types.

Construtores

XmlConvert()

Inicializa uma nova instância da classe XmlConvert.Initializes a new instance of the XmlConvert class.

Métodos

DecodeName(String)

Decodifica um nome.Decodes a name. Esse método faz o inverso dos métodos EncodeName(String) e EncodeLocalName(String).This method does the reverse of the EncodeName(String) and EncodeLocalName(String) methods.

EncodeLocalName(String)

Converte o nome em um nome XML local válido.Converts the name to a valid XML local name.

EncodeName(String)

Converte o nome para um nome XML válido.Converts the name to a valid XML name.

EncodeNmToken(String)

Verifica se que o nome é válido de acordo com a especificação do XML.Verifies the name is valid according to the XML specification.

IsNCNameChar(Char)

Verifica se o caractere transmitido é um tipo de caractere válido diferente de dois-pontos.Checks whether the passed-in character is a valid non-colon character type.

IsPublicIdChar(Char)

Retorna a instância de caractere transmitido se o caractere no argumento for um caractere válido de id pública, caso contrário, null.Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise null.

IsStartNCNameChar(Char)

Verifica se o caractere transmitido é um tipo válido de caractere de nome inicial.Checks if the passed-in character is a valid Start Name Character type.

IsWhitespaceChar(Char)

Verifica se o caractere transmitido é um caractere de espaço em branco XML válido.Checks if the passed-in character is a valid XML whitespace character.

IsXmlChar(Char)

Verifica se o caractere passado é um caractere XML válido.Checks if the passed-in character is a valid XML character.

IsXmlSurrogatePair(Char, Char)

Verifica se o par alternativo de caracteres transmitido é um caractere XML válido.Checks if the passed-in surrogate pair of characters is a valid XML character.

ToBoolean(String)

Converte o String em um Boolean equivalente.Converts the String to a Boolean equivalent.

ToByte(String)

Converte o String em um Byte equivalente.Converts the String to a Byte equivalent.

ToChar(String)

Converte o String em um Char equivalente.Converts the String to a Char equivalent.

ToDateTime(String)
Obsoleto.

Converte o String em um DateTime equivalente.Converts the String to a DateTime equivalent.

ToDateTime(String, String)

Converte o String em um DateTime equivalente.Converts the String to a DateTime equivalent.

ToDateTime(String, String[])

Converte o String em um DateTime equivalente.Converts the String to a DateTime equivalent.

ToDateTime(String, XmlDateTimeSerializationMode)

Converte o String em um DateTime usando o XmlDateTimeSerializationMode especificado.Converts the String to a DateTime using the XmlDateTimeSerializationMode specified.

ToDateTimeOffset(String)

Converte o String fornecido em um DateTimeOffset equivalente.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String)

Converte o String fornecido em um DateTimeOffset equivalente.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String[])

Converte o String fornecido em um DateTimeOffset equivalente.Converts the supplied String to a DateTimeOffset equivalent.

ToDecimal(String)

Converte o String em um Decimal equivalente.Converts the String to a Decimal equivalent.

ToDouble(String)

Converte o String em um Double equivalente.Converts the String to a Double equivalent.

ToGuid(String)

Converte o String em um Guid equivalente.Converts the String to a Guid equivalent.

ToInt16(String)

Converte o String em um Int16 equivalente.Converts the String to a Int16 equivalent.

ToInt32(String)

Converte o String em um Int32 equivalente.Converts the String to a Int32 equivalent.

ToInt64(String)

Converte o String em um Int64 equivalente.Converts the String to a Int64 equivalent.

ToSByte(String)

Converte o String em um SByte equivalente.Converts the String to a SByte equivalent.

ToSingle(String)

Converte o String em um Single equivalente.Converts the String to a Single equivalent.

ToString(Boolean)

Converte o Boolean para um String.Converts the Boolean to a String.

ToString(Byte)

Converte o Byte para um String.Converts the Byte to a String.

ToString(Char)

Converte o Char para um String.Converts the Char to a String.

ToString(DateTime)
Obsoleto.

Converte o DateTime para um String.Converts the DateTime to a String.

ToString(DateTime, String)

Converte o DateTime para um String.Converts the DateTime to a String.

ToString(DateTime, XmlDateTimeSerializationMode)

Converte o DateTime em um String usando o XmlDateTimeSerializationMode especificado.Converts the DateTime to a String using the XmlDateTimeSerializationMode specified.

ToString(DateTimeOffset)

Converte o DateTimeOffset fornecido em um String.Converts the supplied DateTimeOffset to a String.

ToString(DateTimeOffset, String)

Converte o DateTimeOffset fornecido em um String no formato especificado.Converts the supplied DateTimeOffset to a String in the specified format.

ToString(Decimal)

Converte o Decimal para um String.Converts the Decimal to a String.

ToString(Double)

Converte o Double para um String.Converts the Double to a String.

ToString(Guid)

Converte o Guid para um String.Converts the Guid to a String.

ToString(Int16)

Converte o Int16 para um String.Converts the Int16 to a String.

ToString(Int32)

Converte o Int32 para um String.Converts the Int32 to a String.

ToString(Int64)

Converte o Int64 para um String.Converts the Int64 to a String.

ToString(SByte)

Converte o SByte para um String.Converts the SByte to a String.

ToString(Single)

Converte o Single para um String.Converts the Single to a String.

ToString(TimeSpan)

Converte o TimeSpan para um String.Converts the TimeSpan to a String.

ToString(UInt16)

Converte o UInt16 para um String.Converts the UInt16 to a String.

ToString(UInt32)

Converte o UInt32 para um String.Converts the UInt32 to a String.

ToString(UInt64)

Converte o UInt64 para um String.Converts the UInt64 to a String.

ToTimeSpan(String)

Converte o String em um TimeSpan equivalente.Converts the String to a TimeSpan equivalent.

ToUInt16(String)

Converte o String em um UInt16 equivalente.Converts the String to a UInt16 equivalent.

ToUInt32(String)

Converte o String em um UInt32 equivalente.Converts the String to a UInt32 equivalent.

ToUInt64(String)

Converte o String em um UInt64 equivalente.Converts the String to a UInt64 equivalent.

VerifyName(String)

Verifica se o nome é um nome válido de acordo com a recomendação de W3C Extended Markup Language.Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.

VerifyNCName(String)

Verifica se o nome é um NCName válido de acordo com a recomendação de W3C Extended Markup Language.Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. Um NCName é um nome que não pode conter dois-pontos.An NCName is a name that cannot contain a colon.

VerifyNMTOKEN(String)

Verifica se a cadeia de caracteres é um NMTOKEN válido de acordo com a recomendação do W3C de Esquema de XML Parte 2: Recomendação de tipos de dados.Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyPublicId(String)

Retorna a instância de cadeia de caracteres transmitida se todos os caracteres no argumento de cadeia de caracteres forem caracteres de ID pública válidos.Returns the passed in string instance if all the characters in the string argument are valid public id characters.

VerifyTOKEN(String)

Verifica se a cadeia de caracteres é um token válido de acordo com a recomendação do W3C de Esquema de XML Parte 2: tipos de dados.Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyWhitespace(String)

Retorna a instância de cadeia de caracteres transmitida se todos os caracteres no argumento de cadeia de caracteres forem caracteres de espaço em branco válidos.Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.

VerifyXmlChars(String)

Retorna a cadeia de caracteres passada se todos os caracteres e os caracteres do par substituto no argumento de cadeia de caracteres forem caracteres XML válidos, caso contrário, um XmlException será gerado com informações sobre o primeiro caractere inválido encontrado.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.

Aplica-se a