EnumConverter 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.
Fournit un convertisseur de type pour convertir Enum des objets vers et à partir de différentes 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
- Dérivé
Exemples
L’exemple de code suivant convertit une variable de type Enum en chaîne, et vice versa. L’exemple nécessite que vous ayez déclaré un Enum appelé Servers et qu’il possède 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 ne peut convertir qu’un objet d’énumération vers et à partir d’une chaîne. La EnumConverter classe fournit la Comparer propriété pour 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 types, consultez la TypeConverter classe de base et How to : Implement a Type Converter.
Note
Vous ne devez jamais créer une instance d’un EnumConverter. Appelez plutôt la GetConverter méthode de la TypeDescriptor classe. Pour plus d’informations, consultez les exemples de la TypeConverter classe de base.
Notes pour les héritiers
Si vous souhaitez trier les valeurs dans un ordre différent, remplacez la Comparer propriété.
Constructeurs
| Nom | Description |
|---|---|
| EnumConverter(Type) |
Initialise une nouvelle instance de la EnumConverter classe pour le type donné. |
Propriétés
| Nom | Description |
|---|---|
| Comparer |
Obtient un 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 une TypeConverter.StandardValuesCollection valeur qui spécifie les valeurs possibles pour l’énumération. |
Méthodes
| Nom | Description |
|---|---|
| CanConvertFrom(ITypeDescriptorContext, Type) |
Obtient une valeur indiquant si ce convertisseur peut convertir un objet dans le type source donné en objet d’énumération à l’aide du contexte spécifié. |
| CanConvertFrom(Type) |
Retourne si ce convertisseur peut convertir un objet du type donné en type de ce convertisseur. (Hérité de TypeConverter) |
| CanConvertTo(ITypeDescriptorContext, Type) |
Obtient une valeur indiquant si ce convertisseur peut convertir un objet en type de destination donné à l’aide du contexte. |
| CanConvertTo(Type) |
Retourne si ce convertisseur peut convertir l’objet en type spécifié. (Hérité de TypeConverter) |
| ConvertFrom(ITypeDescriptorContext, CultureInfo, Object) |
Convertit l’objet valeur spécifié en objet d’énumération. |
| ConvertFrom(Object) |
Convertit la valeur donnée en type de ce convertisseur. (Hérité de TypeConverter) |
| ConvertFromInvariantString(ITypeDescriptorContext, String) |
Convertit la chaîne donnée en type de ce convertisseur, à l’aide de la culture invariante et du contexte spécifié. (Hérité de TypeConverter) |
| ConvertFromInvariantString(String) |
Convertit la chaîne donnée en type de ce convertisseur à l’aide de la culture invariante. (Hérité de TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, CultureInfo, String) |
Convertit le texte donné en objet à l’aide des informations de contexte et de culture spécifiées. (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 valeur donné en type de destination spécifié. |
| ConvertTo(Object, Type) |
Convertit l’objet valeur donné en 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 invariante de culture à l’aide du contexte spécifié. (Hérité de TypeConverter) |
| ConvertToInvariantString(Object) |
Convertit la valeur spécifiée en une représentation sous forme de chaîne invariante de culture. (Hérité de TypeConverter) |
| ConvertToString(ITypeDescriptorContext, CultureInfo, Object) |
Convertit la valeur donnée en représentation sous forme de chaîne, à l’aide des informations de contexte et de culture spécifiées. (Hérité de TypeConverter) |
| ConvertToString(ITypeDescriptorContext, Object) |
Convertit la valeur donnée en représentation sous forme de chaîne à l’aide du contexte donné. (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 ensemble donné de valeurs de propriété pour l’objet. (Hérité de TypeConverter) |
| CreateInstance(ITypeDescriptorContext, IDictionary) |
Crée une instance du type auquel cela TypeConverter est associé, à l’aide du contexte spécifié, en fonction d’un ensemble de valeurs de propriété pour 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 lorsqu’une conversion ne peut pas être effectuée. (Hérité de TypeConverter) |
| GetConvertToException(Object, Type) |
Retourne une exception à lever lorsqu’une conversion ne peut pas être effectuée. (Hérité de TypeConverter) |
| GetCreateInstanceSupported() |
Retourne si la modification d’une valeur sur cet objet nécessite un appel à la CreateInstance(IDictionary) méthode pour créer une nouvelle valeur. (Hérité de TypeConverter) |
| GetCreateInstanceSupported(ITypeDescriptorContext) |
Retourne si la modification d’une valeur sur cet objet nécessite un appel pour CreateInstance(IDictionary) créer une valeur, à l’aide du contexte spécifié. (Hérité de TypeConverter) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetProperties(ITypeDescriptorContext, Object, Attribute[]) |
Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre valeur, à l’aide du contexte et des attributs spécifiés. (Hérité de TypeConverter) |
| GetProperties(ITypeDescriptorContext, Object) |
Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre valeur, à l’aide du contexte spécifié. (Hérité de TypeConverter) |
| GetProperties(Object) |
Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre valeur. (Hérité de TypeConverter) |
| GetPropertiesSupported() |
Retourne si cet objet prend en charge les propriétés. (Hérité de TypeConverter) |
| GetPropertiesSupported(ITypeDescriptorContext) |
Retourne si cet objet prend en charge les propriétés à l’aide du contexte spécifié. (Hérité de TypeConverter) |
| GetStandardValues() |
Retourne une collection de valeurs standard à partir du contexte par défaut pour le 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 si la collection de valeurs standard retournées GetStandardValues() est une liste exclusive. (Hérité de TypeConverter) |
| GetStandardValuesExclusive(ITypeDescriptorContext) |
Obtient une valeur indiquant si la liste des valeurs standard retournées GetStandardValues() est une liste exclusive à l’aide du contexte spécifié. |
| GetStandardValuesSupported() |
Retourne si cet objet prend en charge un ensemble 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 un ensemble standard de valeurs qui peuvent être sélectionnées dans une liste à l’aide du contexte spécifié. |
| GetType() |
Obtient la 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 si l’objet valeur donné est valide pour ce type. (Hérité de TypeConverter) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (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) |