XmlConvert Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XmlConvert, classe

 

Encode et décode les noms XML, et fournit des méthodes pour la conversion entre les types Common Language Runtime et les types XSD (XML Schema Definition).Lors de la conversion de types de données, les valeurs retournées sont indépendantes des paramètres régionaux.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

System.Object
  System.Xml.XmlConvert

public class XmlConvert

NomDescription
System_CAPS_pubmethodXmlConvert()

Initialise une nouvelle instance de la classe XmlConvert.

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticDecodeName(String)

Décode un nom.Cette méthode fait le contraire des méthodes EncodeName et EncodeLocalName.

System_CAPS_pubmethodSystem_CAPS_staticEncodeLocalName(String)

Convertit le nom en un nom local XML valide.

System_CAPS_pubmethodSystem_CAPS_staticEncodeName(String)

Convertit le nom en un nom XML valide.

System_CAPS_pubmethodSystem_CAPS_staticEncodeNmToken(String)

Vérifie que le nom est valide selon la spécification XML.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut. (Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticIsNCNameChar(Char)

Vérifie si le caractère passé est un type de caractère autre que deux-points valide.

System_CAPS_pubmethodSystem_CAPS_staticIsPublicIdChar(Char)

Retourne l'instance du caractère passé si le caractère de l'argument est un caractère d'ID public valide, sinon null.

System_CAPS_pubmethodSystem_CAPS_staticIsStartNCNameChar(Char)

Vérifie si le caractère passé est un type de caractère de début de nom valide.

System_CAPS_pubmethodSystem_CAPS_staticIsWhitespaceChar(Char)

Vérifie si le caractère passé est un caractère d'espace XML valide.

System_CAPS_pubmethodSystem_CAPS_staticIsXmlChar(Char)

Vérifie si le caractère passé est un caractère XML valide.

System_CAPS_pubmethodSystem_CAPS_staticIsXmlSurrogatePair(Char, Char)

Vérifie si la paire de caractères de substitution passée est un caractère XML valide.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticToBoolean(String)

Convertit la chaîne String en un équivalent Boolean.

System_CAPS_pubmethodSystem_CAPS_staticToByte(String)

Convertit la chaîne String en un équivalent Byte.

System_CAPS_pubmethodSystem_CAPS_staticToChar(String)

Convertit la chaîne String en un équivalent Char.

System_CAPS_pubmethodSystem_CAPS_staticToDateTime(String)

Obsolète.Convertit la chaîne String en un équivalent DateTime.

System_CAPS_pubmethodSystem_CAPS_staticToDateTime(String, String)

Convertit la chaîne String en un équivalent DateTime.

System_CAPS_pubmethodSystem_CAPS_staticToDateTime(String, String[])

Convertit la chaîne String en un équivalent DateTime.

System_CAPS_pubmethodSystem_CAPS_staticToDateTime(String, XmlDateTimeSerializationMode)

Convertit la chaîne String en un élément DateTime en utilisant le mode XmlDateTimeSerializationMode spécifié.

System_CAPS_pubmethodSystem_CAPS_staticToDateTimeOffset(String)

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

System_CAPS_pubmethodSystem_CAPS_staticToDateTimeOffset(String, String)

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

System_CAPS_pubmethodSystem_CAPS_staticToDateTimeOffset(String, String[])

Convertit la chaîne String fournie en un équivalent DateTimeOffset.

System_CAPS_pubmethodSystem_CAPS_staticToDecimal(String)

Convertit la chaîne String en un équivalent Decimal.

System_CAPS_pubmethodSystem_CAPS_staticToDouble(String)

Convertit la chaîne String en un équivalent Double.

System_CAPS_pubmethodSystem_CAPS_staticToGuid(String)

Convertit la chaîne String en un équivalent Guid.

System_CAPS_pubmethodSystem_CAPS_staticToInt16(String)

Convertit la chaîne String en un équivalent Int16.

System_CAPS_pubmethodSystem_CAPS_staticToInt32(String)

Convertit la chaîne String en un équivalent Int32.

System_CAPS_pubmethodSystem_CAPS_staticToInt64(String)

Convertit la chaîne String en un équivalent Int64.

System_CAPS_pubmethodSystem_CAPS_staticToSByte(String)

Convertit la chaîne String en un équivalent SByte.

System_CAPS_pubmethodSystem_CAPS_staticToSingle(String)

Convertit la chaîne String en un équivalent Single.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticToString(Boolean)

Convertit le Boolean en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Byte)

Convertit le Byte en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Char)

Convertit le Char en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(DateTime)

Obsolète.Convertit le DateTime en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(DateTime, String)

Convertit le DateTime en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(DateTime, XmlDateTimeSerializationMode)

Convertit l'élément DateTime en une chaîne String en utilisant le mode XmlDateTimeSerializationMode spécifié.

System_CAPS_pubmethodSystem_CAPS_staticToString(DateTimeOffset)

Convertit l'élément DateTimeOffset fourni en une chaîne String.

System_CAPS_pubmethodSystem_CAPS_staticToString(DateTimeOffset, String)

Convertit l'élément DateTimeOffset fourni en une chaîne String dans le format spécifié.

System_CAPS_pubmethodSystem_CAPS_staticToString(Decimal)

Convertit le Decimal en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Double)

Convertit le Double en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Guid)

Convertit le Guid en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Int16)

Convertit le Int16 en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Int32)

Convertit le Int32 en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Int64)

Convertit le Int64 en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(SByte)

Convertit le SByte en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(Single)

Convertit le Single en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(TimeSpan)

Convertit le TimeSpan en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(UInt16)

Convertit le UInt16 en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(UInt32)

Convertit le UInt32 en String.

System_CAPS_pubmethodSystem_CAPS_staticToString(UInt64)

Convertit le UInt64 en String.

System_CAPS_pubmethodSystem_CAPS_staticToTimeSpan(String)

Convertit la chaîne String en un équivalent TimeSpan.

System_CAPS_pubmethodSystem_CAPS_staticToUInt16(String)

Convertit la chaîne String en un équivalent UInt16.

System_CAPS_pubmethodSystem_CAPS_staticToUInt32(String)

Convertit la chaîne String en un équivalent UInt32.

System_CAPS_pubmethodSystem_CAPS_staticToUInt64(String)

Convertit la chaîne String en un équivalent UInt64.

System_CAPS_pubmethodSystem_CAPS_staticVerifyName(String)

Vérifie que le nom est un nom valide selon la recommandation W3C XML (Extended Markup Language).

System_CAPS_pubmethodSystem_CAPS_staticVerifyNCName(String)

Vérifie que le nom est un NCName valide selon la recommandation W3C XML (Extended Markup Language).Un élément NCName est un nom qui ne peut pas contenir un signe deux-points.

System_CAPS_pubmethodSystem_CAPS_staticVerifyNMTOKEN(String)

Vérifie que la chaîne est un NMTOKEN valide selon la recommandation du W3C intitulée XML Schema Part2 : Datatypes

System_CAPS_pubmethodSystem_CAPS_staticVerifyPublicId(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 publics valides.

System_CAPS_pubmethodSystem_CAPS_staticVerifyTOKEN(String)

Vérifie que la chaîne est un jeton valide selon la recommandation du W3C intitulée XML Schema Part 2 : Datatypes

System_CAPS_pubmethodSystem_CAPS_staticVerifyWhitespace(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'espace valides.

System_CAPS_pubmethodSystem_CAPS_staticVerifyXmlChars(String)

Retourne les caractères de la chaîne passée si tous les caractères et caractères de la paire de substitution de l'argument de chaîne sont des caractères XML valides, sinon une exception XmlException est levée avec des informations relatives au premier caractère non valide rencontré.

Le XmlConvert classe est fonctionnellement équivalente à la Convert classe, mais il prend en charge les normes XML.Le système de type est fondé sur le type de schéma en langage XSD (XML Schema Definition), et les valeurs de retour sont toujours indépendantes des paramètres régionaux.

Les noms et les valeurs d'ID sont limités à une plage de caractères XML selon le W3C XML 1.0 recommendation.Lorsque les noms contiennent des caractères non valides, vous pouvez utiliser la EncodeName et DecodeName méthodes de cette classe pour les convertir en noms XML valides.

Par exemple, si vous souhaitez utiliser l'en-tête de colonne « Order Detail » dans une base de données, la base de données permet l'espace entre les deux mots.Toutefois, dans XML, l'espace entre « Order » et « Détail » est considéré comme un caractère XML non valide.Vous devez le convertir en un code hexadécimal d'échappement et décoder ultérieurement.

Vous pouvez utiliser la EncodeName méthode avec la XmlWriter classe pour 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 éléments suivants XmlConvert méthodes effectuent le codage et le décodage.

Méthode

Description

EncodeName

Prend un nom et retourne le nom codé avec n'importe quel caractère non valide est remplacé par une chaîne d'échappement.Cette méthode permet de deux-points dans n'importe quelle position, ce qui signifie que le nom peut néanmoins être non valide selon le W3C Namespaces in XML 1.0 recommendation.

EncodeNmToken

Prend un nom et retourne le nom encodé.

EncodeLocalName

Identique à EncodeName sauf qu'elle code également le caractère deux-points, ce qui garantit que le nom peut être utilisé comme le LocalName fait partie d'un nom qualifié d'espace de noms.

DecodeName

Inverse la transformation réalisée par toutes les méthodes d'encodage.

Le XmlConvert classe contient deux méthodes qui vérifient les caractères d'un nom d'élément ou d'attribut et vérifiez que le nom est conforme aux règles définies par le W3C XML 1.0 recommendation:

  • VerifyName contrôle les caractères et vérifie que le nom est valide.La méthode retourne le nom si elle est valide et lève une exception si elle n'est pas.

  • VerifyNCName effectue la même validation, mais accepte les noms non qualifiés.

La XmlConvert contient des méthodes supplémentaires qui valident les jetons, blancs, ID publics et autres chaînes.

XmlConvert fournit également des méthodes qui vous permettent de convertir des données d'une chaîne en un type de données fortement typées.Par exemple, le ToDateTime méthode convertit une chaîne en ses DateTime équivalente.Cela est utile, car la plupart des méthodes dans le XmlReader classe retournent des données sous forme de chaîne.Une fois que les données sont lues, elle peut être convertie au type de données approprié avant d'être utilisé.Le ToString surcharges offrent l'opération complémentaire en convertissant les données fortement typées en chaînes.Par exemple, cela est utile lorsque vous souhaitez ajouter les données à des zones de texte sur une page Web.Paramètres régionaux ne sont pas prises en compte lors de la conversion de données.Les types de données sont basées sur les types de données XSD (XML Schema).

Universal Windows Platform
Disponible depuis 4.5
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft