XmlConvert Clase

Definición

Codifica y descodifica nombres XML y proporciona métodos de conversión entre tipos de Common Language Runtime y tipos de lenguajes de definición de esquema XML (XSD).Encodes and decodes XML names, and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. Cuando se convierten tipos de datos, los valores devueltos no dependen de la configuración regional.When converting data types, the values returned are locale-independent.

public ref class XmlConvert
public class XmlConvert
type XmlConvert = class
Public Class XmlConvert
Herencia
XmlConvert

Comentarios

La clase XmlConvert es funcionalmente equivalente a la clase Convert, pero admite los estándares XML.The XmlConvert class is functionally equivalent to the Convert class, but it supports XML standards. El sistema de tipos se basa en el tipo de esquema de lenguaje de definición de esquemas XML (XSD) y los valores devueltos siempre son independientes de la configuración regional.The type system is based on the XML Schema definition language (XSD) schema type, and the values returned are always locale-independent.

Codificar y descodificarEncoding and decoding

Los nombres de elementos y atributos o los valores de identificador se limitan a un intervalo de caracteres XML de acuerdo con la recomendación xml 1,0de W3C.Element and attribute names or ID values are limited to a range of XML characters according to the W3C XML 1.0 recommendation. Cuando los nombres contienen caracteres no válidos, puede utilizar los métodos EncodeName y DecodeName de esta clase para convertirlos en nombres 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 ejemplo, si desea utilizar el encabezado de columna "Order detail" en una base de datos, la base de datos permite el espacio entre las dos palabras.For example, if you want to use the column heading "Order Detail" in a database, the database allows the space between the two words. Sin embargo, en XML, el espacio entre "Order" y "detail" se considera un carácter XML no válido.However, in XML, the space between "Order" and "Detail" is considered an invalid XML character. Tendrá que convertirlo en una codificación hexadecimal con escape y descodificarlo más adelante.You have to convert it into an escaped hexadecimal encoding and decode it later.

Puede usar el método EncodeName con la clase XmlWriter para asegurarse de que los nombres que se escriben son nombres XML válidos.You can use the EncodeName method with the XmlWriter class to ensure the names being written are valid XML names. El código C# siguiente convierte el nombre "Order detail" en un nombre XML válido y escribe el 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");

Los siguientes métodos XmlConvert realizan la codificación y la descodificación.The following XmlConvert methods perform encoding and decoding.

MétodoMethod DescripciónDescription
EncodeName Toma un nombre y devuelve el nombre codificado junto con los caracteres no válidos que se reemplazan por una cadena de escape.Takes a name and returns the encoded name along with any invalid character that is replaced by an escape string. Este método permite dos puntos en cualquier posición, lo que significa que el nombre todavía puede ser no válido de acuerdo con los espacios de nombres del W3C en la recomendación de 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 Toma un nombre y devuelve el nombre codificado.Takes a name and returns the encoded name.
EncodeLocalName Igual que EncodeName, salvo que también codifica el carácter de dos puntos, lo que garantiza que el nombre se puede usar como la parte LocalName de un nombre calificado con el espacio de nombres.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 Invierte la transformación para todos los métodos de codificación.Reverses the transformation for all the encoding methods.

Validación de nombresName validation

La clase XmlConvert contiene dos métodos que comprueban los caracteres de un nombre de elemento o atributo y comprueban que el nombre se ajusta a las reglas establecidas por la recomendación XML 1,0de W3C: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 comprueba los caracteres y comprueba que el nombre es válido.VerifyName checks the characters and verifies that the name is valid. El método devuelve el nombre si es válido y produce una excepción si no lo es.The method returns the name if it's valid, and throws an exception if it isn't.

  • VerifyNCName realiza la misma validación, pero acepta nombres no completos.VerifyNCName performs the same validation, but accepts non-qualified names.

El XmlConvert contiene métodos adicionales que validan los tokens, los caracteres de espacio en blanco, los identificadores públicos y otras cadenas.The XmlConvert contains additional methods that validate tokens, white-space characters, public IDs, and other strings.

Conversión de tipos de datosData type conversion

XmlConvert también proporciona métodos que permiten convertir datos de una cadena en un tipo de datos fuertemente tipado.XmlConvert also provides methods that enable you to convert data from a string to a strongly typed data type. Por ejemplo, el método ToDateTime convierte una cadena en su equivalente DateTime.For example, the ToDateTime method converts a string to its DateTime equivalent. Esto resulta útil porque la mayoría de los métodos de la clase XmlReader devuelven datos como una cadena.This is useful because most methods in the XmlReader class return data as a string. Una vez leídos los datos, se pueden convertir al tipo de datos adecuado antes de utilizarlos.After the data is read, it can be converted to the proper data type before being used. Las sobrecargas ToString proporcionan la operación complementaria mediante la conversión de datos fuertemente tipados a cadenas.The ToString overloads provide the complementary operation by converting strongly typed data to strings. Por ejemplo, esto es útil si desea agregar los datos a los cuadros de texto de una página web.For example, this is useful when you want to add the data to text boxes on a webpage. La configuración regional no se tiene en cuenta durante la conversión de datos.Locale settings are not taken into account during data conversion. Los tipos de datos se basan en los tipos de datos de esquemas XML (XSD).The data types are based on the XML Schema (XSD) data types.

Constructores

XmlConvert()

Inicializa una nueva instancia de la clase XmlConvert.Initializes a new instance of the XmlConvert class.

Métodos

DecodeName(String)

Descodifica un nombre.Decodes a name. Este método hace lo contrario que los métodos EncodeName(String) y EncodeLocalName(String).This method does the reverse of the EncodeName(String) and EncodeLocalName(String) methods.

EncodeLocalName(String)

Convierte el nombre en un nombre XML local válido.Converts the name to a valid XML local name.

EncodeName(String)

Convierte el nombre en un nombre XML válido.Converts the name to a valid XML name.

EncodeNmToken(String)

Comprueba que el nombre es válido de acuerdo con la especificación XML.Verifies the name is valid according to the XML specification.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsNCNameChar(Char)

Comprueba si el carácter pasado es un tipo de carácter distinto de dos puntos válido.Checks whether the passed-in character is a valid non-colon character type.

IsPublicIdChar(Char)

Devuelve la instancia de carácter pasada si el carácter del argumento es un carácter de identificador público válido; en caso contrario, null.Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise null.

IsStartNCNameChar(Char)

Comprueba si el carácter pasado es un tipo Start Name Character válido.Checks if the passed-in character is a valid Start Name Character type.

IsWhitespaceChar(Char)

Comprueba si el carácter pasado es un carácter de espacio en blanco XML válido.Checks if the passed-in character is a valid XML whitespace character.

IsXmlChar(Char)

Comprueba si el carácter pasado es un carácter XML válido.Checks if the passed-in character is a valid XML character.

IsXmlSurrogatePair(Char, Char)

Comprueba si el par de caracteres suplentes pasado es un carácter XML válido.Checks if the passed-in surrogate pair of characters is a valid XML character.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToBoolean(String)

Convierte el String en un Boolean equivalente.Converts the String to a Boolean equivalent.

ToByte(String)

Convierte el String en un Byte equivalente.Converts the String to a Byte equivalent.

ToChar(String)

Convierte el String en un Char equivalente.Converts the String to a Char equivalent.

ToDateTime(String)

Convierte el String en un DateTime equivalente.Converts the String to a DateTime equivalent.

ToDateTime(String, String)

Convierte el String en un DateTime equivalente.Converts the String to a DateTime equivalent.

ToDateTime(String, String[])

Convierte el String en un DateTime equivalente.Converts the String to a DateTime equivalent.

ToDateTime(String, XmlDateTimeSerializationMode)

Convierte String en DateTime mediante el XmlDateTimeSerializationMode especificado.Converts the String to a DateTime using the XmlDateTimeSerializationMode specified.

ToDateTimeOffset(String)

Convierte la String proporcionada en un equivalente de DateTimeOffset.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String)

Convierte la String proporcionada en un equivalente de DateTimeOffset.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String[])

Convierte la String proporcionada en un equivalente de DateTimeOffset.Converts the supplied String to a DateTimeOffset equivalent.

ToDecimal(String)

Convierte el String en un Decimal equivalente.Converts the String to a Decimal equivalent.

ToDouble(String)

Convierte el String en un Double equivalente.Converts the String to a Double equivalent.

ToGuid(String)

Convierte el String en un Guid equivalente.Converts the String to a Guid equivalent.

ToInt16(String)

Convierte el String en un Int16 equivalente.Converts the String to a Int16 equivalent.

ToInt32(String)

Convierte el String en un Int32 equivalente.Converts the String to a Int32 equivalent.

ToInt64(String)

Convierte el String en un Int64 equivalente.Converts the String to a Int64 equivalent.

ToSByte(String)

Convierte el String en un SByte equivalente.Converts the String to a SByte equivalent.

ToSingle(String)

Convierte el String en un Single equivalente.Converts the String to a Single equivalent.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
ToString(Boolean)

Convierte la clase Boolean en una clase String.Converts the Boolean to a String.

ToString(Byte)

Convierte la clase Byte en una clase String.Converts the Byte to a String.

ToString(Char)

Convierte la clase Char en una clase String.Converts the Char to a String.

ToString(DateTime)

Convierte la clase DateTime en una clase String.Converts the DateTime to a String.

ToString(DateTime, String)

Convierte la clase DateTime en una clase String.Converts the DateTime to a String.

ToString(DateTime, XmlDateTimeSerializationMode)

Convierte DateTime en String mediante el XmlDateTimeSerializationMode especificado.Converts the DateTime to a String using the XmlDateTimeSerializationMode specified.

ToString(DateTimeOffset)

Convierte el DateTimeOffset proporcionado en una String.Converts the supplied DateTimeOffset to a String.

ToString(DateTimeOffset, String)

Convierte el DateTimeOffset proporcionado en una String con el formato especificado.Converts the supplied DateTimeOffset to a String in the specified format.

ToString(Decimal)

Convierte la clase Decimal en una clase String.Converts the Decimal to a String.

ToString(Double)

Convierte la clase Double en una clase String.Converts the Double to a String.

ToString(Guid)

Convierte la clase Guid en una clase String.Converts the Guid to a String.

ToString(Int16)

Convierte la clase Int16 en una clase String.Converts the Int16 to a String.

ToString(Int32)

Convierte la clase Int32 en una clase String.Converts the Int32 to a String.

ToString(Int64)

Convierte la clase Int64 en una clase String.Converts the Int64 to a String.

ToString(SByte)

Convierte la clase SByte en una clase String.Converts the SByte to a String.

ToString(Single)

Convierte la clase Single en una clase String.Converts the Single to a String.

ToString(TimeSpan)

Convierte la clase TimeSpan en una clase String.Converts the TimeSpan to a String.

ToString(UInt16)

Convierte la clase UInt16 en una clase String.Converts the UInt16 to a String.

ToString(UInt32)

Convierte la clase UInt32 en una clase String.Converts the UInt32 to a String.

ToString(UInt64)

Convierte la clase UInt64 en una clase String.Converts the UInt64 to a String.

ToTimeSpan(String)

Convierte el String en un TimeSpan equivalente.Converts the String to a TimeSpan equivalent.

ToUInt16(String)

Convierte el String en un UInt16 equivalente.Converts the String to a UInt16 equivalent.

ToUInt32(String)

Convierte el String en un UInt32 equivalente.Converts the String to a UInt32 equivalent.

ToUInt64(String)

Convierte el String en un UInt64 equivalente.Converts the String to a UInt64 equivalent.

VerifyName(String)

Comprueba que el nombre sea válido de acuerdo con la recomendación sobre el lenguaje de marcado extensible del Consorcio W3C.Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.

VerifyNCName(String)

Comprueba que el nombre sea un NCName válido de acuerdo con la recomendación sobre el lenguaje de marcado extensible del Consorcio W3C.Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. NCName es un nombre que no puede contener un carácter de dos puntos.An NCName is a name that cannot contain a colon.

VerifyNMTOKEN(String)

Comprueba que la cadena sea un elemento NMTOKEN válido de acuerdo con la recomendación del Consorcio W3C "XML Schema Part 2: Datatypes" (Parte 2 del esquema XML: tipos de datos).Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyPublicId(String)

Devuelve la instancia de cadena pasada si todos los caracteres del argumento de cadena son caracteres de identificadores públicos válidos.Returns the passed in string instance if all the characters in the string argument are valid public id characters.

VerifyTOKEN(String)

Comprueba que la cadena sea un token válido de acuerdo con la recomendación del Consorcio W3C "XML Schema Part 2: Datatypes" (Parte 2 del esquema XML: tipos de datos).Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyWhitespace(String)

Devuelve la instancia de cadena pasada si todos los caracteres del argumento de cadena son caracteres de espacio en blanco válidos.Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.

VerifyXmlChars(String)

Devuelve la cadena que se pasa si todos los caracteres y pares de caracteres suplentes de un argumento de la cadena son caracteres XML válidos, en caso contrario se produce una XmlException con información sobre el primer carácter no vá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.

Se aplica a