XmlConvert Classe

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblies:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origem:
XmlConvert.cs
Origem:
XmlConvert.cs
Origem:
XmlConvert.cs
Origem:
XmlConvert.cs
Origem:
XmlConvert.cs

Codifica e decodifica nomes XML e fornece métodos para conversão entre tipos de common language runtime e tipos XSD (linguagem de definição de esquema XML). Ao converter tipos de dados, os valores retornados são independentes de localidade.

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
Object
XmlConvert

Comentários

A XmlConvert classe é funcionalmente equivalente à Convert classe, mas dá suporte a padrões XML. O sistema de tipos é baseado no tipo de esquema XSD (linguagem de definição de esquema XML) e os valores retornados são sempre independentes de localidade.

Codificação e decodificação

Os nomes de elemento e atributo 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 métodos EncodeName e DecodeName nesta classe para convertê-los em nomes XML válidos.

Por exemplo, se você quiser usar o título da coluna "Detalhes da Ordem" em um banco de dados, o banco de dados permitirá 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ê deve convertê-lo em uma codificação hexadecimal escapada e decodificá-lo posteriormente.

Você pode usar o EncodeName método com a XmlWriter classe para garantir que os nomes gravados sejam nomes XML válidos. O código C# a seguir converte o nome "Detalhe da Ordem" 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");

XmlConvert Os métodos a seguir executam a codificação e a decodificação.

Método Description
EncodeName Usa um nome e retorna o nome codificado junto com qualquer caractere inválido que seja substituído por uma cadeia de caracteres de escape. Este 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 XML 1.0.
EncodeNmToken Usa um nome e retorna o nome codificado.
EncodeLocalName Equivalente a EncodeName, exceto pelo fato de que ele também codifica o caractere dois-pontos, garantindo que o nome possa ser usado como a parte LocalName de um nome qualificado do namespace.
DecodeName Inverte a transformação para todos os métodos de codificação.

Validação de nome

A XmlConvert classe contém dois métodos que verificam os caracteres em um elemento ou nome de 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 retornará o nome se for válido e gerará 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 em um tipo de dados fortemente tipado. Por exemplo, o ToDateTime método converte uma cadeia de caracteres em seu DateTime equivalente. Isso é útil porque a maioria dos métodos na XmlReader classe retorna dados como uma cadeia de caracteres. Depois que os dados são lidos, eles podem ser convertidos no tipo de dados adequado antes de serem usados. As sobrecargas ToString fornecem a operação complementar convertendo 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 XSD (Esquema XML).

Construtores

Nome Description
XmlConvert()

Inicializa uma nova instância da classe XmlConvert.

Métodos

Nome Description
DecodeName(String)

Decodifica um nome. Esse método faz o inverso dos métodos e EncodeName(String) dos EncodeLocalName(String) métodos.
EncodeLocalName(String)

Converte o nome em um nome local XML válido.
EncodeName(String)

Converte o nome em um nome XML válido.
EncodeNmToken(String)

Verifica se o nome é válido de acordo com a especificação XML.
IsNCNameChar(Char)

Verifica se o caractere passado é um tipo de caractere não-dois-pontos válido.
IsPublicIdChar(Char)

Retorna a instância de caractere passado se o caractere no argumento for um caractere de ID público válido, caso contrário null.
IsStartNCNameChar(Char)

Verifica se o caractere passado é um tipo de caractere de nome de início válido.
IsWhitespaceChar(Char)

Verifica se o caractere passado é um caractere de espaço em branco XML válido.
IsXmlChar(Char)

Verifica se o caractere passado é um caractere XML válido.
IsXmlSurrogatePair(Char, Char)

Verifica se o par substituto de caracteres passado é um caractere XML válido.
ToBoolean(String)

Converte em String um Boolean equivalente.
ToByte(String)

Converte em String um Byte equivalente.
ToChar(String)

Converte em String um Char equivalente.
ToDateTime(String, String)

Converte em String um DateTime equivalente.
ToDateTime(String, String[])

Converte em String um DateTime equivalente.
ToDateTime(String, XmlDateTimeSerializationMode)

Converte em String um DateTime usando o XmlDateTimeSerializationMode especificado.
ToDateTime(String)
Obsoleto.
Obsoleto.

Converte em String um DateTime equivalente.
ToDateTimeOffset(String, String)

Converte o fornecido String em um DateTimeOffset equivalente.
ToDateTimeOffset(String, String[])

Converte o fornecido String em um DateTimeOffset equivalente.
ToDateTimeOffset(String)

Converte o fornecido String em um DateTimeOffset equivalente.
ToDecimal(String)

Converte em String um Decimal equivalente.
ToDouble(String)

Converte em String um Double equivalente.
ToGuid(String)

Converte em String um Guid equivalente.
ToInt16(String)

Converte em String um Int16 equivalente.
ToInt32(String)

Converte em String um Int32 equivalente.
ToInt64(String)

Converte em String um Int64 equivalente.
ToSByte(String)

Converte em String um SByte equivalente.
ToSingle(String)

Converte em String um Single equivalente.
ToString(Boolean)

Converte em Boolean um String.
ToString(Byte)

Converte em Byte um String.
ToString(Char)

Converte em Char um String.
ToString(DateTime, String)

Converte em DateTime um String.
ToString(DateTime, XmlDateTimeSerializationMode)

Converte em DateTime um String usando o XmlDateTimeSerializationMode especificado.
ToString(DateTime)
Obsoleto.
Obsoleto.

Converte em DateTime um String.
ToString(DateTimeOffset, String)

Converte o fornecido DateTimeOffset em um String no formato especificado.
ToString(DateTimeOffset)

Converte o fornecido DateTimeOffset em um String.
ToString(Decimal)

Converte em Decimal um String.
ToString(Double)

Converte em Double um String.
ToString(Guid)

Converte em Guid um String.
ToString(Int16)

Converte em Int16 um String.
ToString(Int32)

Converte em Int32 um String.
ToString(Int64)

Converte em Int64 um String.
ToString(SByte)

Converte em SByte um String.
ToString(Single)

Converte em Single um String.
ToString(TimeSpan)

Converte em TimeSpan um String.
ToString(UInt16)

Converte em UInt16 um String.
ToString(UInt32)

Converte em UInt32 um String.
ToString(UInt64)

Converte em UInt64 um String.
ToTimeSpan(String)

Converte em String um TimeSpan equivalente.
ToUInt16(String)

Converte em String um UInt16 equivalente.
ToUInt32(String)

Converte em String um UInt32 equivalente.
ToUInt64(String)

Converte em String um UInt64 equivalente.
VerifyName(String)

Verifica se o nome é um nome válido de acordo com a recomendação da Linguagem de Marcação Estendida W3C.
VerifyNCName(String)

Verifica se o nome é válido NCName de acordo com a recomendação da Linguagem de Marcação Estendida W3C. Um NCName é um nome que não pode conter dois-pontos.
VerifyNMTOKEN(String)

Verifica se a cadeia de caracteres é uma NMTOKEN válida de acordo com a recomendação W3C XML Schema Part2: Datatypes.
VerifyPublicId(String)

Retorna a instância de cadeia de caracteres passada se todos os caracteres no argumento de cadeia de caracteres forem caracteres de ID público válidos.
VerifyTOKEN(String)

Verifica se a cadeia de caracteres é um token válido de acordo com a recomendação W3C XML Schema Part2: Datatypes.
VerifyWhitespace(String)

Retorna a instância de cadeia de caracteres passada se todos os caracteres no argumento de cadeia de caracteres forem caracteres de espaço em branco válidos.
VerifyXmlChars(String)

Retorna a cadeia de caracteres passada se todos os caracteres e caracteres de par alternativos 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.

Aplica-se a