EnumConverter 類別

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

來源:

EnumConverter.cs

提供型別轉換子 (Type Converter) 將 Enum 物件與其他各種表示相互轉換。

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

public class EnumConverter : System.ComponentModel.TypeConverter

type EnumConverter = class
    inherit TypeConverter

Public Class EnumConverter
Inherits TypeConverter

繼承

Object

TypeConverter

EnumConverter

衍生

System.Drawing.FontConverter.FontUnitConverter

範例

下列程式代碼範例會將 類型的 Enum 變數轉換成字串，反之亦然。 此範例會要求您宣告名為 Servers 的 Enum ，而且其具有下列成員：

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))

備註

這個轉換子只能將列舉物件轉換成字串，以及從字串轉換。 類別 EnumConverter 提供 Comparer 屬性，以取得 IComparer 可用來排序列舉值的介面。 根據預設，列舉值會依出現在檔案中的順序排序。

如需類型轉換器的詳細資訊，請參閱 TypeConverter 基類和 如何：實作類型轉換器。

注意

您不應該建立的 EnumConverter實例。 請改為呼叫 GetConverter 類別的 TypeDescriptor 方法。 如需詳細資訊，請參閱基類中的 TypeConverter 範例。

給繼承者的注意事項

如果您想要將值排序成不同的順序，請覆寫 Comparer 屬性。

建構函式

EnumConverter(Type)

初始化指定型別之 EnumConverter 類別的新執行個體。

屬性

Comparer	取得可以用於排序列舉型別之值的 IComparer。
EnumType	指定這個轉換子關聯的列舉值型別。
Values	取得或設定 TypeConverter.StandardValuesCollection，指定列舉型別的可能值。

方法

CanConvertFrom(ITypeDescriptorContext, Type)	取得值，指出這個轉換子是否可以使用指定的內容，將指定來源型別中的物件轉換成列舉型別物件。
CanConvertFrom(Type)	傳回值，指出這個轉換子是否可將指定之型別的物件轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	取得值，表示這個轉換子是否可以使用內容將物件轉換成指定的目的型別。
CanConvertTo(Type)	傳回值，指出這個轉換子是否可以將物件轉換成指定的型別。 (繼承來源 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	將指定的值物件轉換為列舉型別物件。
ConvertFrom(Object)	會將指定值轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	會使用不區分的文化特性和指定的內容，將指定的字串轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromInvariantString(String)	會使用不因文化特性而異，將指定字串轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	會使用指定內容和文化特性資訊，將指定文字轉換為物件。 (繼承來源 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	會使用指定的內容，將指定文字轉換為物件。 (繼承來源 TypeConverter)
ConvertFromString(String)	會將指定的文字轉換成物件。 (繼承來源 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	將指定的數值物件轉換成指定的目的型別。
ConvertTo(Object, Type)	會使用引數，將指定值物件轉換成指定型別。 (繼承來源 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	會使用指定的內容，將指定值轉換成不因文化特性而異的字串表示。 (繼承來源 TypeConverter)
ConvertToInvariantString(Object)	會將指定值轉換成不因文化特性而異的字串表示。 (繼承來源 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	會使用指定的內容和文化特性資訊，將指定值轉換為字串表示。 (繼承來源 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	會使用指定的內容，將指定值轉換為字串表示。 (繼承來源 TypeConverter)
ConvertToString(Object)	會將指定值轉換成字串表示。 (繼承來源 TypeConverter)
CreateInstance(IDictionary)	重新建立 Object，需為物件提供一組屬性值。 (繼承來源 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	使用指定的內容，建立與這個 TypeConverter 相關聯之類型的執行個體，並為物件提供一組屬性值。 (繼承來源 TypeConverter)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetConvertFromException(Object)	傳回要在無法執行轉換時擲回的例外狀況。 (繼承來源 TypeConverter)
GetConvertToException(Object, Type)	傳回要在無法執行轉換時擲回的例外狀況。 (繼承來源 TypeConverter)
GetCreateInstanceSupported()	傳回值，指出在這個物件上變更值時是否需要呼叫 CreateInstance(IDictionary) 方法來建立新值。 (繼承來源 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	傳回在這個物件上變更值是否需要呼叫 CreateInstance(IDictionary) 來建立新的值，並使用指定的內容。 (繼承來源 TypeConverter)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperties(ITypeDescriptorContext, Object)	會使用指定的內容，傳回由值參數所指定之陣列型別的屬性集合。 (繼承來源 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	使用指定的內容和屬性 (attribute)，傳回由該值參數所指定之陣列類型的屬性 (property) 集合。 (繼承來源 TypeConverter)
GetProperties(Object)	傳回由值參數所指定的陣列型別的屬性集合。 (繼承來源 TypeConverter)
GetPropertiesSupported()	傳回值，指出這個物件是否支援屬性。 (繼承來源 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	使用指定的內容，傳回這個物件是否支援屬性。 (繼承來源 TypeConverter)
GetStandardValues()	從為這個型別轉換子所設計的資料型別預設內容中，會傳回標準值的集合。 (繼承來源 TypeConverter)
GetStandardValues(ITypeDescriptorContext)	針對這個驗證程式設計目標的資料型別，取得由該資料型別的標準值所組成的集合。
GetStandardValuesExclusive()	傳回值，指出從 GetStandardValues() 所傳回的標準值集合是否為獨佔清單。 (繼承來源 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	取得值，表示從 GetStandardValues() 所傳回的標準值清單是否為獨佔清單。
GetStandardValuesSupported()	傳回這個物件是否支援可以從清單中選取的標準值集合。 (繼承來源 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	取得值，指出這個物件是否支援可以使用指定內容從清單選取的標準值集合。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsValid(ITypeDescriptorContext, Object)	取得值，表示指定物件值對這個型別是否有效。
IsValid(Object)	會傳回指定值物件是否對這個型別有效。 (繼承來源 TypeConverter)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SortProperties(PropertyDescriptorCollection, String[])	排序屬性的集合。 (繼承來源 TypeConverter)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)