XmlConvert Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Encode et décode les noms XML et fournit des méthodes de conversion entre les types Common Language Runtime et les types XSD (XML Schema Definition Language). Lors de la conversion de types de données, les valeurs retournées sont indépendantes des paramètres régionaux.
public ref class XmlConvert abstract sealedpublic ref class XmlConvertpublic static class XmlConvertpublic class XmlConverttype XmlConvert = classPublic Class XmlConvert- Héritage
-
XmlConvert
Remarques
La XmlConvert classe est fonctionnellement équivalente à la Convert classe, mais elle prend en charge les normes XML. Le système de type est basé sur le type de schéma XSD (XML Schema Definition Language) et les valeurs retournées sont toujours indépendantes des paramètres régionaux.
Encodage et décodage
Les noms d’éléments et d’attributs ou les valeurs d’ID sont limités à une plage de caractères XML en fonction de la recommandation W3C XML 1.0. Lorsque les noms contiennent des caractères non valides, vous pouvez utiliser les méthodes EncodeName et DecodeName de cette classe pour les traduire en noms XML valides.
Par exemple, si vous souhaitez utiliser l’en-tête de colonne « Détail de l’ordre » dans une base de données, la base de données autorise l’espace entre les deux mots. Toutefois, en XML, l’espace entre « Order » et « Detail » est considéré comme un caractère XML non valide. Vous devez le convertir en encodage hexadécimal d’échappement et le décoder ultérieurement.
Vous pouvez utiliser la EncodeName méthode avec la XmlWriter classe pour vous assurer que les noms écrits sont des noms XML valides. Le code C# suivant convertit le nom « Order Detail » en un nom XML valide et écrit l’élément <Order_0x0020_Detail>My order</Order_0x0020_Detail>.
writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
Les méthodes suivantes XmlConvert effectuent l’encodage et le décodage.
| Méthode | Description |
|---|---|
| EncodeName | Prend un nom et retourne le nom encodé, où tout caractère non valide est remplacé par une chaîne d’échappement. Cette méthode autorise les deux-points à n’importe quelle position, ce qui signifie que le nom peut toujours être invalide selon la recommandation Namespaces in XML 1.0 du W3C. |
| EncodeNmToken | Prend un nom et retourne le nom encodé. |
| EncodeLocalName | Identique à EncodeName sauf qu’il encode également le caractère deux-points, garantissant que le nom peut être utilisé comme la partie LocalName d’un nom qualifié par un espace de noms. |
| DecodeName | Inverse la transformation pour toutes les méthodes d’encodage. |
Validation de nom
La XmlConvert classe contient deux méthodes qui vérifient les caractères d’un nom d’élément ou d’attribut et vérifient que le nom est conforme aux règles définies par la recommandation W3C XML 1.0 :
- VerifyName vérifie les caractères et vérifie que le nom est valide. La méthode retourne le nom s’il est valide et lève une exception si ce n’est pas le cas.
- VerifyNCName effectue la même validation, mais accepte des noms non qualifiés.
La classe XmlConvert contient des méthodes supplémentaires qui valident les jetons, les espaces blancs, les ID publics et d'autres chaînes.
Conversion de types de données
XmlConvert fournit également des méthodes qui vous permettent de convertir des données d’une chaîne en type de données fortement typé. Par exemple, la ToDateTime méthode convertit une chaîne en son DateTime équivalent. Cela est utile, car la plupart des méthodes de la XmlReader classe retournent des données sous forme de chaîne. Une fois les données lues, elles peuvent être converties en type de données approprié avant d’être utilisées. Les surcharges ToString fournissent l’opération complémentaire en convertissant des données fortement typées en chaînes. Par exemple, cela est utile lorsque vous souhaitez ajouter les données aux zones de texte d’une page web. Les paramètres régionaux ne sont pas pris en compte lors de la conversion des données. Les types de données sont basés sur les types de données XML Schema (XSD).
Constructeurs
| Nom | Description |
|---|---|
| XmlConvert() |
Initialise une nouvelle instance de la classe XmlConvert. |
Méthodes
| Nom | Description |
|---|---|
| DecodeName(String) |
Décodage un nom. Cette méthode effectue l’inverse des méthodes et EncodeName(String) des EncodeLocalName(String) méthodes. |
| EncodeLocalName(String) |
Convertit le nom en nom local XML valide. |
| EncodeName(String) |
Convertit le nom en nom XML valide. |
| EncodeNmToken(String) |
Vérifie que le nom est valide en fonction de la spécification XML. |
| IsNCNameChar(Char) |
Vérifie si le caractère passé est un type de caractère non-deux-points valide. |
| IsPublicIdChar(Char) |
Retourne l’instance de caractère passée si le caractère de l’argument est un caractère d’ID public valide, sinon |
| IsStartNCNameChar(Char) |
Vérifie si le caractère passé est un type de caractère de nom de début valide. |
| IsWhitespaceChar(Char) |
Vérifie si le caractère transmis est un caractère d’espace blanc XML valide. |
| IsXmlChar(Char) |
Vérifie si le caractère passé est un caractère XML valide. |
| IsXmlSurrogatePair(Char, Char) |
Vérifie si la paire de caractères transmise est un caractère XML valide. |
| ToBoolean(String) | |
| ToByte(String) | |
| ToChar(String) | |
| ToDateTime(String, String) | |
| ToDateTime(String, String[]) | |
| ToDateTime(String, XmlDateTimeSerializationMode) |
Convertit le String fichier en DateTime un à l’aide de l’élément XmlDateTimeSerializationMode spécifié. |
| ToDateTime(String) |
Obsolète.
Obsolète.
|
| ToDateTimeOffset(String, String) |
Convertit le fourni String en DateTimeOffset équivalent. |
| ToDateTimeOffset(String, String[]) |
Convertit le fourni String en DateTimeOffset équivalent. |
| ToDateTimeOffset(String) |
Convertit le fourni String en DateTimeOffset équivalent. |
| 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) |
Convertit le DateTime fichier en String un à l’aide de l’élément XmlDateTimeSerializationMode spécifié. |
| ToString(DateTime) |
Obsolète.
Obsolète.
|
| ToString(DateTimeOffset, String) |
Convertit le fourni DateTimeOffsetString au format spécifié. |
| ToString(DateTimeOffset) |
Convertit le fourni DateTimeOffset en 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) |
Vérifie que le nom est un nom valide en fonction de la recommandation W3C Extended Markup Language. |
| VerifyNCName(String) |
Vérifie que le nom est valide |
| VerifyNMTOKEN(String) |
Vérifie que la chaîne est un NMTOKEN valide conformément à la recommandation W3C XML Schema Part2 : Datatypes. |
| VerifyPublicId(String) |
Retourne l’instance de chaîne passée si tous les caractères de l’argument de chaîne sont des caractères d’ID public valides. |
| VerifyTOKEN(String) |
Vérifie que la chaîne est un jeton valide conformément à la recommandation W3C XML Schema Part2 : Datatypes. |
| VerifyWhitespace(String) |
Retourne l’instance de chaîne passée si tous les caractères de l’argument de chaîne sont des espaces blancs valides. |
| VerifyXmlChars(String) |
Retourne la chaîne transmise si tous les caractères et les caractères de paire de substitution dans l’argument de chaîne sont des caractères XML valides, sinon une |
