EnumConverter Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

EnumConverter.cs

Fournit un convertisseur de type pour convertir les objets Enum vers et à partir d'autres représentations.

public ref class EnumConverter : System::ComponentModel::TypeConverter

public class EnumConverter : System.ComponentModel.TypeConverter

type EnumConverter = class
    inherit TypeConverter

Public Class EnumConverter
Inherits TypeConverter

Héritage

Object

TypeConverter

EnumConverter

Dérivé

System.Drawing.FontConverter.FontUnitConverter

Exemples

L’exemple de code suivant convertit une variable de type Enum en chaîne, et inversement. L’exemple exige que vous ayez déclaré un Enum appelé Servers et qu’il ait les membres suivants :

Windows=1, Exchange=2, BizTalk=3  

// Requires public declaration of the following type.
// __value enum Servers {Windows=1, Exchange=2, BizTalk=3};
Servers myServer = Servers::Exchange;
String^ myServerString = "BizTalk";
Console::WriteLine( TypeDescriptor::GetConverter( myServer )->ConvertTo( myServer, String::typeid ) );
Console::WriteLine( TypeDescriptor::GetConverter( myServer )->ConvertFrom( myServerString ) );

Enum myServer= Servers.Exchange;
string myServerString = "BizTalk";
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertTo(myServer, typeof(string))); 
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertFrom(myServerString));

Dim myServer As Servers = Servers.Exchange
Dim myServerString As string = "BizTalk"
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertTo(myServer, GetType(String))) 
Console.WriteLine(TypeDescriptor.GetConverter(myServer).ConvertFrom(myServerString))

Remarques

Ce convertisseur peut uniquement convertir un objet d’énumération vers et à partir d’une chaîne. La EnumConverter classe fournit la Comparer propriété permettant d’obtenir une IComparer interface qui peut être utilisée pour trier les valeurs de l’énumération. Par défaut, les valeurs d’énumération sont triées dans l’ordre dans lequel elles apparaissent dans le fichier.

Pour plus d’informations sur les convertisseurs de type, consultez la TypeConverter classe de base et Guide pratique pour implémenter un convertisseur de type.

Notes

Vous ne devez jamais créer une instance d’un EnumConverter. Au lieu de cela, appelez la méthode GetConverter de la classe TypeDescriptor. Pour plus d’informations, consultez les exemples de la classe de TypeConverter base.

Notes pour les héritiers

Si vous souhaitez trier les valeurs dans un autre ordre, remplacez la Comparer propriété .

Constructeurs

EnumConverter(Type)

Initialise une nouvelle instance de la classe EnumConverter pour le type donné.

Propriétés

Comparer	Obtient IComparer qui peut être utilisé pour trier les valeurs de l'énumération.
EnumType	Spécifie le type de l'énumérateur auquel ce convertisseur est associé.
Values	Obtient ou définit un TypeConverter.StandardValuesCollection qui spécifie les valeurs possibles pour l'énumération.

Méthodes

CanConvertFrom(ITypeDescriptorContext, Type)	Obtient une valeur indiquant si ce convertisseur peut convertir un objet du type source donné en objet d'énumération à l'aide du contexte spécifié.
CanConvertFrom(Type)	Retourne une valeur indiquant si ce convertisseur peut convertir un objet du type donné en objet du type de ce convertisseur. (Hérité de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Obtient une valeur indiquant si ce convertisseur peut convertir un objet en objet du type de destination donné en utilisant le contexte.
CanConvertTo(Type)	Retourne une valeur indiquant si ce convertisseur peut convertir l'objet en objet du type spécifié. (Hérité de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Convertit l'objet de valeur spécifié en objet d'énumération.
ConvertFrom(Object)	Convertit la valeur donnée en valeur du type de ce convertisseur. (Hérité de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Convertit la chaîne donnée au type de ce convertisseur, à l'aide des informations de culture indifférente et du contexte spécifiés. (Hérité de TypeConverter)
ConvertFromInvariantString(String)	Convertit la chaîne donnée en représentation sous forme de chaîne du type de ce convertisseur, à l'aide de la culture dite indifférente. (Hérité de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Convertit le texte donné en objet, à l'aide du contexte et des informations de culture spécifiés. (Hérité de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Convertit le texte donné en objet, à l'aide du contexte spécifié. (Hérité de TypeConverter)
ConvertFromString(String)	Convertit le texte spécifié en objet. (Hérité de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Convertit l'objet de valeur donnée en type de destination spécifié.
ConvertTo(Object, Type)	Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments. (Hérité de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Convertit la valeur spécifiée en représentation sous forme de chaîne de culture dite indifférente, à l'aide du contexte déterminé. (Hérité de TypeConverter)
ConvertToInvariantString(Object)	Convertit la valeur spécifiée en représentation sous forme de chaîne de culture dite indifférente. (Hérité de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Convertit la valeur donnée en représentation sous forme de chaîne, à l'aide du contexte et des informations de culture spécifiés. (Hérité de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Convertit la valeur donnée en représentation sous forme de chaîne, à l'aide du contexte déterminé. (Hérité de TypeConverter)
ConvertToString(Object)	Convertit la valeur spécifiée en représentation sous forme de chaîne. (Hérité de TypeConverter)
CreateInstance(IDictionary)	Recrée un Object en fonction d'un jeu de valeurs de propriétés de l'objet. (Hérité de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Crée une instance du type auquel ce TypeConverter est associé, en utilisant le contexte spécifié, en fonction d’un ensemble de valeurs de propriétés de l’objet. (Hérité de TypeConverter)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetConvertFromException(Object)	Retourne une exception à lever quand une conversion ne peut pas être effectuée. (Hérité de TypeConverter)
GetConvertToException(Object, Type)	Retourne une exception à lever quand une conversion ne peut pas être effectuée. (Hérité de TypeConverter)
GetCreateInstanceSupported()	Retourne une valeur indiquant si la modification d'une valeur de cet objet nécessite un appel à la méthode CreateInstance(IDictionary) pour créer une nouvelle valeur. (Hérité de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Retourne une valeur indiquant si la modification d’une valeur de cet objet nécessite un appel à CreateInstance(IDictionary) pour créer une valeur, en utilisant le contexte spécifié. (Hérité de TypeConverter)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperties(ITypeDescriptorContext, Object)	Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur, à l'aide du contexte déterminé. (Hérité de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur, à l’aide du contexte et des attributs spécifiés. (Hérité de TypeConverter)
GetProperties(Object)	Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur. (Hérité de TypeConverter)
GetPropertiesSupported()	Retourne une valeur indiquant si l'objet prend en charge les propriétés. (Hérité de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Retourne une valeur qui indique si cet objet prend en charge les propriétés en utilisant le contexte spécifié. (Hérité de TypeConverter)
GetStandardValues()	Retourne une collection de valeurs standard à partir du contexte par défaut du type de données pour lequel ce convertisseur de type est conçu. (Hérité de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Obtient une collection de valeurs standard pour le type de données pour lequel ce validateur est conçu.
GetStandardValuesExclusive()	Retourne une valeur indiquant si la collection de valeurs standard retournée par GetStandardValues() est une liste exclusive. (Hérité de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Obtient une valeur indiquant si la liste de valeurs standard retournée par GetStandardValues() est une liste exclusive à l'aide du contexte spécifié.
GetStandardValuesSupported()	Retourne une valeur indiquant si cet objet prend en charge un jeu standard de valeurs qui peuvent être sélectionnées dans une liste. (Hérité de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Obtient une valeur indiquant si cet objet prend en charge une série de valeurs standard qui peuvent être sélectionnées dans une liste, à l'aide du contexte spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsValid(ITypeDescriptorContext, Object)	Obtient une valeur indiquant si la valeur d'objet donnée est valide pour ce type.
IsValid(Object)	Retourne une valeur indiquant si l'objet de valeur donné est valide pour ce type. (Hérité de TypeConverter)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SortProperties(PropertyDescriptorCollection, String[])	Trie une collection de propriétés. (Hérité de TypeConverter)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)