EnumConverter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Typkonverter zum Konvertieren Enum von Objekten in und aus verschiedenen anderen Darstellungen bereit.
public ref class EnumConverter : System::ComponentModel::TypeConverterpublic class EnumConverter : System.ComponentModel.TypeConvertertype EnumConverter = class
inherit TypeConverterPublic Class EnumConverter
Inherits TypeConverter- Vererbung
- Abgeleitet
Beispiele
Im folgenden Codebeispiel wird eine Variable vom Typ Enum in eine Zeichenfolge konvertiert und umgekehrt. Das Beispiel erfordert, dass Sie einen Enum Aufruf Servers deklariert haben und dass es die folgenden Member enthält:
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))
Hinweise
Dieser Konverter kann nur ein Enumerationsobjekt in und aus einer Zeichenfolge konvertieren. Die EnumConverter Klasse stellt die Comparer Eigenschaft bereit, um eine IComparer Schnittstelle abzurufen, die zum Sortieren der Werte der Enumeration verwendet werden kann. Standardmäßig werden die Enumerationswerte in der Reihenfolge sortiert, in der sie in der Datei angezeigt werden.
Weitere Informationen zu Typkonvertern finden Sie in der TypeConverter Basisklasse und vorgehensweise: Implementieren eines Typkonverters.
Hinweis
Sie sollten niemals eine Instanz einer EnumConverter. Rufen Sie stattdessen die GetConverter Methode der TypeDescriptor Klasse auf. Weitere Informationen finden Sie in den Beispielen in der TypeConverter Basisklasse.
Hinweise für Vererber
Wenn Sie die Werte in einer anderen Reihenfolge sortieren möchten, überschreiben Sie die Comparer Eigenschaft.
Konstruktoren
| Name | Beschreibung |
|---|---|
| EnumConverter(Type) |
Initialisiert eine neue Instanz der EnumConverter Klasse für den angegebenen Typ. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Comparer |
Ruft ein IComparer , das zum Sortieren der Werte der Enumeration verwendet werden kann. |
| EnumType |
Gibt den Typ des Enumerators an, dem dieser Konverter zugeordnet ist. |
| Values |
Dient zum Abrufen oder Festlegen eines TypeConverter.StandardValuesCollection Werts, der die möglichen Werte für die Enumeration angibt. |
Methoden
| Name | Beschreibung |
|---|---|
| CanConvertFrom(ITypeDescriptorContext, Type) |
Ruft einen Wert ab, der angibt, ob dieser Konverter ein Objekt im angegebenen Quelltyp mithilfe des angegebenen Kontexts in ein Enumerationsobjekt konvertieren kann. |
| CanConvertFrom(Type) |
Gibt zurück, ob dieser Konverter ein Objekt des angegebenen Typs in den Typ dieses Konverters konvertieren kann. (Geerbt von TypeConverter) |
| CanConvertTo(ITypeDescriptorContext, Type) |
Ruft einen Wert ab, der angibt, ob dieser Konverter ein Objekt mithilfe des Kontexts in den angegebenen Zieltyp konvertieren kann. |
| CanConvertTo(Type) |
Gibt zurück, ob dieser Konverter das Objekt in den angegebenen Typ konvertieren kann. (Geerbt von TypeConverter) |
| ConvertFrom(ITypeDescriptorContext, CultureInfo, Object) |
Konvertiert das angegebene Wertobjekt in ein Enumerationsobjekt. |
| ConvertFrom(Object) |
Konvertiert den angegebenen Wert in den Typ dieses Konverters. (Geerbt von TypeConverter) |
| ConvertFromInvariantString(ITypeDescriptorContext, String) |
Konvertiert die angegebene Zeichenfolge in den Typ dieses Konverters, wobei die invariante Kultur und der angegebene Kontext verwendet werden. (Geerbt von TypeConverter) |
| ConvertFromInvariantString(String) |
Konvertiert die angegebene Zeichenfolge in den Typ dieses Konverters unter Verwendung der invarianten Kultur. (Geerbt von TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, CultureInfo, String) |
Konvertiert den angegebenen Text in ein Objekt mithilfe der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, String) |
Konvertiert den angegebenen Text mithilfe des angegebenen Kontexts in ein Objekt. (Geerbt von TypeConverter) |
| ConvertFromString(String) |
Konvertiert den angegebenen Text in ein Objekt. (Geerbt von TypeConverter) |
| ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) |
Konvertiert das angegebene Wertobjekt in den angegebenen Zieltyp. |
| ConvertTo(Object, Type) |
Konvertiert das angegebene Wertobjekt mithilfe der Argumente in den angegebenen Typ. (Geerbt von TypeConverter) |
| ConvertToInvariantString(ITypeDescriptorContext, Object) |
Wandelt den angegebenen Wert mithilfe des angegebenen Kontexts in eine kulturinvariante Zeichenfolgendarstellung um. (Geerbt von TypeConverter) |
| ConvertToInvariantString(Object) |
Konvertiert den angegebenen Wert in eine kulturinvariante Zeichenfolgendarstellung. (Geerbt von TypeConverter) |
| ConvertToString(ITypeDescriptorContext, CultureInfo, Object) |
Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung mithilfe der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter) |
| ConvertToString(ITypeDescriptorContext, Object) |
Wandelt den angegebenen Wert mithilfe des angegebenen Kontexts in eine Zeichenfolgendarstellung um. (Geerbt von TypeConverter) |
| ConvertToString(Object) |
Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter) |
| CreateInstance(IDictionary) |
Erstellt einen Object bestimmten Satz von Eigenschaftswerten für das Objekt erneut. (Geerbt von TypeConverter) |
| CreateInstance(ITypeDescriptorContext, IDictionary) |
Erstellt eine Instanz des Typs, dem dies TypeConverter mithilfe des angegebenen Kontexts zugeordnet ist, wobei eine Reihe von Eigenschaftswerten für das Objekt angegeben ist. (Geerbt von TypeConverter) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetConvertFromException(Object) |
Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht ausgeführt werden kann. (Geerbt von TypeConverter) |
| GetConvertToException(Object, Type) |
Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht ausgeführt werden kann. (Geerbt von TypeConverter) |
| GetCreateInstanceSupported() |
Gibt zurück, ob das Ändern eines Werts für dieses Objekt einen Aufruf der CreateInstance(IDictionary) Methode erfordert, um einen neuen Wert zu erstellen. (Geerbt von TypeConverter) |
| GetCreateInstanceSupported(ITypeDescriptorContext) |
Gibt zurück, ob beim Ändern eines Werts für dieses Objekt ein Aufruf zum CreateInstance(IDictionary) Erstellen eines neuen Werts mithilfe des angegebenen Kontexts erforderlich ist. (Geerbt von TypeConverter) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetProperties(ITypeDescriptorContext, Object, Attribute[]) |
Gibt eine Auflistung von Eigenschaften für den Arraytyp zurück, der durch den Wertparameter angegeben wird, wobei der angegebene Kontext und die angegebenen Attribute verwendet werden. (Geerbt von TypeConverter) |
| GetProperties(ITypeDescriptorContext, Object) |
Gibt eine Auflistung von Eigenschaften für den Vom Wertparameter angegebenen Arraytyp mithilfe des angegebenen Kontexts zurück. (Geerbt von TypeConverter) |
| GetProperties(Object) |
Gibt eine Auflistung von Eigenschaften für den Arraytyp zurück, der durch den Wertparameter angegeben wird. (Geerbt von TypeConverter) |
| GetPropertiesSupported() |
Gibt zurück, ob dieses Objekt Eigenschaften unterstützt. (Geerbt von TypeConverter) |
| GetPropertiesSupported(ITypeDescriptorContext) |
Gibt zurück, ob dieses Objekt Eigenschaften mithilfe des angegebenen Kontexts unterstützt. (Geerbt von TypeConverter) |
| GetStandardValues() |
Gibt eine Auflistung von Standardwerten aus dem Standardkontext für den Datentyp zurück, für den dieser Typkonverter entwickelt wurde. (Geerbt von TypeConverter) |
| GetStandardValues(ITypeDescriptorContext) |
Ruft eine Auflistung von Standardwerten für den Datentyp ab, für den dieser Validator entwickelt wurde. |
| GetStandardValuesExclusive() |
Gibt zurück, ob es sich bei der Auflistung der zurückgegebenen GetStandardValues() Standardwerte um eine exklusive Liste handelt. (Geerbt von TypeConverter) |
| GetStandardValuesExclusive(ITypeDescriptorContext) |
Ruft einen Wert ab, der angibt, ob die Liste der zurückgegebenen Standardwerte GetStandardValues() eine exklusive Liste mit dem angegebenen Kontext ist. |
| GetStandardValuesSupported() |
Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, der aus einer Liste ausgewählt werden kann. (Geerbt von TypeConverter) |
| GetStandardValuesSupported(ITypeDescriptorContext) |
Ruft einen Wert ab, der angibt, ob dieses Objekt einen Standardsatz von Werten unterstützt, die mithilfe des angegebenen Kontexts aus einer Liste ausgewählt werden können. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsValid(ITypeDescriptorContext, Object) |
Ruft einen Wert ab, der angibt, ob der angegebene Objektwert für diesen Typ gültig ist. |
| IsValid(Object) |
Gibt zurück, ob das angegebene Wertobjekt für diesen Typ gültig ist. (Geerbt von TypeConverter) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SortProperties(PropertyDescriptorCollection, String[]) |
Sortiert eine Auflistung von Eigenschaften. (Geerbt von TypeConverter) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
