XmlConvert Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Codifica e decodifica nomes XML e fornece métodos para converter entre tipos de runtime de linguagem comum e tipos XML Schema Definition Language (XSD). Ao converter tipos de dados, os valores devolvidos são independentes da localidade.
public ref class XmlConvert abstract sealedpublic ref class XmlConvertpublic static class XmlConvertpublic class XmlConverttype XmlConvert = classPublic Class XmlConvert- Herança
-
XmlConvert
Observações
A XmlConvert classe é funcionalmente equivalente à Convert classe, mas suporta padrões XML. O sistema de tipos é baseado no tipo de esquema XSD (XML Schema Definition Language), e os valores retornados são sempre independentes da localidade.
Codificação e descodificação
Nomes de elementos e atributos ou valores de ID são limitados a um intervalo de caracteres XML de acordo com a recomendação W3C XML 1.0. Quando os nomes contêm caracteres inválidos, você pode usar os EncodeName métodos e DecodeName nesta classe para traduzi-los em nomes XML válidos.
Por exemplo, se você quiser usar o título da coluna "Detalhes do pedido" em um banco de dados, o banco de dados permite o espaço entre as duas palavras. No entanto, em XML, o espaço entre "Order" e "Detail" é considerado um caractere XML inválido. Você tem que convertê-lo em uma codificação hexadecimal escapada e decodificá-lo mais tarde.
Você pode usar o EncodeName método com a XmlWriter classe para garantir que os nomes que estão sendo escritos sejam nomes XML válidos. O código C# a seguir converte o nome "Order Detail" em um nome XML válido e grava o elemento <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.
| Método | Description |
|---|---|
| EncodeName | Recebe um nome e retorna o nome codificado junto com qualquer caractere inválido que seja substituído por uma cadeia de escape. Esse método permite dois pontos em qualquer posição, o que significa que o nome ainda pode ser inválido de acordo com a recomendação W3C Namespaces in XML 1.0. |
| EncodeNmToken | Usa um nome e retorna o nome codificado. |
| EncodeLocalName | O mesmo que EncodeName exceto que ele também codifica o caractere de dois pontos, garantindo que o nome possa ser usado como parte LocalName de um nome qualificado para namespace. |
| DecodeName | Reverte a transformação para todos os métodos de codificação. |
Validação do nome
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á em conformidade com as regras definidas pela recomendação W3C XML 1.0:
- VerifyName verifica os caracteres e verifica se o nome é válido. O método retorna o nome se for válido e lança uma exceção se não for.
- VerifyNCName Executa a mesma validação, mas aceita nomes não qualificados.
O XmlConvert contém métodos adicionais que validam tokens, caracteres de espaço em branco, IDs públicas e outras cadeias de caracteres.
Conversão de tipo de dados
XmlConvert também fornece métodos que permitem converter dados de uma cadeia de caracteres para um tipo de dados fortemente tipado. Por exemplo, o método converte ToDateTime uma cadeia de caracteres em seu DateTime equivalente. Isso é útil porque a XmlReader maioria dos métodos na classe retorna dados como uma cadeia de caracteres. Depois que os dados são lidos, eles podem ser convertidos para o tipo de dados adequado antes de serem usados. As sobrecargas ToString fornecem a operação complementar ao converter dados fortemente tipados em cadeias de caracteres. Por exemplo, isso é útil quando você deseja adicionar os dados a caixas de texto em uma página da Web. As configurações de localidade não são levadas em conta durante a conversão de dados. Os tipos de dados são baseados nos tipos de dados do esquema XML (XSD).
Construtores
| Name | Descrição |
|---|---|
| XmlConvert() |
Inicializa uma nova instância da XmlConvert classe. |
Métodos
| Name | Descrição |
|---|---|
| DecodeName(String) |
Decifra um nome. Este método faz o oposto dos EncodeName(String) métodos and EncodeLocalName(String) . |
| EncodeLocalName(String) |
Converte o nome para um nome local XML válido. |
| EncodeName(String) |
Converte o nome num nome XML válido. |
| EncodeNmToken(String) |
Verifica se o nome é válido de acordo com a especificação XML. |
| IsNCNameChar(Char) |
Verifica se o carácter transmitido é um tipo válido que não inclua dois dois-pontos. |
| IsPublicIdChar(Char) |
Devolve a instância do carácter passado se o carácter no argumento for um carácter id público válido, caso contrário |
| IsStartNCNameChar(Char) |
Verifica se o carácter passado é um tipo válido de Nome de Incomeço. |
| IsWhitespaceChar(Char) |
Verifica se o carácter passado é um espaço em branco XML válido. |
| IsXmlChar(Char) |
Verifica se o carácter passado é um carácter XML válido. |
| IsXmlSurrogatePair(Char, Char) |
Verifica se o par de caracteres substituto passado é um carácter XML válido. |
| ToBoolean(String) | |
| ToByte(String) | |
| ToChar(String) | |
| ToDateTime(String, String) | |
| ToDateTime(String, String[]) | |
| ToDateTime(String, XmlDateTimeSerializationMode) |
Converte o String em a DateTime usando o XmlDateTimeSerializationMode especificado. |
| ToDateTime(String) |
Obsoleto.
Obsoleto.
|
| ToDateTimeOffset(String, String) |
Converte o fornecido String para um DateTimeOffset equivalente. |
| ToDateTimeOffset(String, String[]) |
Converte o fornecido String para um DateTimeOffset equivalente. |
| ToDateTimeOffset(String) |
Converte o fornecido String para um DateTimeOffset equivalente. |
| ToDecimal(String) | |
| ToDouble(String) | |
| ToGuid(String) | |
| ToInt16(String) | |
| ToInt32(String) | |
| ToInt64(String) | |
| ToSByte(String) | |
| ToSingle(String) | |
| ToString(Boolean) | |
| ToString(Byte) | |
| ToString(Char) | |
| ToString(DateTime, String) | |
| ToString(DateTime, XmlDateTimeSerializationMode) |
Converte o DateTime em a String usando o XmlDateTimeSerializationMode especificado. |
| ToString(DateTime) |
Obsoleto.
Obsoleto.
|
| ToString(DateTimeOffset, String) |
Converte o fornecido DateTimeOffset para a String no formato especificado. |
| ToString(DateTimeOffset) |
Converte o fornecido DateTimeOffset num String. |
| ToString(Decimal) | |
| ToString(Double) | |
| ToString(Guid) | |
| ToString(Int16) | |
| ToString(Int32) | |
| ToString(Int64) | |
| ToString(SByte) | |
| ToString(Single) | |
| ToString(TimeSpan) | |
| ToString(UInt16) | |
| ToString(UInt32) | |
| ToString(UInt64) | |
| ToTimeSpan(String) | |
| ToUInt16(String) | |
| ToUInt32(String) | |
| ToUInt64(String) | |
| VerifyName(String) |
Verifica se o nome é válido de acordo com a recomendação da Linguagem de Marcação Estendida do W3C. |
| VerifyNCName(String) |
Verifica se o nome é válido |
| VerifyNMTOKEN(String) |
Verifica se a cadeia é um NMTOKEN válido de acordo com a recomendação do Esquema XML do W3C Parte 2: Tipos de dados. |
| VerifyPublicId(String) |
Retorna a instância passada em string se todos os caracteres no argumento string forem caracteres de id público válidos. |
| VerifyTOKEN(String) |
Verifica se a cadeia é um token válido de acordo com a recomendação do Esquema XML do W3C Parte 2: Tipos de dados. |
| VerifyWhitespace(String) |
Devolve a instância de string passada se todos os caracteres no argumento da string forem caracteres de espaço em branco válidos. |
| VerifyXmlChars(String) |
Devolve a cadeia passada se todos os caracteres e os caracteres substitutos no argumento da cadeia forem caracteres XML válidos, caso contrário, um |
