EnumConverter Classe

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Origem:

EnumConverter.cs

Fornece um conversor de tipo para converter objetos Enum para e de diversas outras representações.

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

public class EnumConverter : System.ComponentModel.TypeConverter

type EnumConverter = class
    inherit TypeConverter

Public Class EnumConverter
Inherits TypeConverter

Herança

Object

TypeConverter

EnumConverter

Derivado

System.Drawing.FontConverter.FontUnitConverter

Exemplos

O exemplo de código a seguir converte uma variável do tipo Enum em uma cadeia de caracteres e vice-versa. O exemplo exige que você tenha declarado um Enum chamado Servers e que ele tenha os seguintes membros:

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

Comentários

Esse conversor só pode converter um objeto de enumeração de e para uma cadeia de caracteres. A EnumConverter classe fornece a Comparer propriedade para obter uma IComparer interface que pode ser usada para classificar os valores da enumeração. Por padrão, os valores de enumeração são classificados na ordem em que aparecem no arquivo.

Para obter mais informações sobre conversores de tipo, consulte a TypeConverter classe base e Como implementar um conversor de tipo.

Observação

Você nunca deve criar uma instância de um EnumConverter. Em vez disso, chame o GetConverter método da TypeDescriptor classe . Para obter mais informações, consulte os exemplos na TypeConverter classe base.

Notas aos Herdeiros

Se você quiser classificar os valores em uma ordem diferente, substitua a Comparer propriedade .

Construtores

EnumConverter(Type)

Inicializa uma nova instância da classe EnumConverter para o caminho fornecido.

Propriedades

Comparer	Obtém um IComparer que pode ser usado para classificar os valores da enumeração.
EnumType	Especifica o tipo de enumerador ao qual esse conversor está associado.
Values	Obtém ou define um TypeConverter.StandardValuesCollection que especifica os valores possíveis para a enumeração.

Métodos

CanConvertFrom(ITypeDescriptorContext, Type)	Obtém um valor que indica se este conversor pode converter um objeto no tipo de origem especificado para um objeto de enumeração usando o contexto especificado.
CanConvertFrom(Type)	Retorna se este conversor pode converter um objeto do tipo indicado para o tipo deste conversor. (Herdado de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Obtém um valor que indica se este conversor pode converter um objeto no tipo de destino fornecido usando o contexto.
CanConvertTo(Type)	Retorna se esse conversor pode converter o objeto para o tipo especificado. (Herdado de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Converte o objeto de valor especificado em um objeto de enumeração.
ConvertFrom(Object)	Converte o valor fornecido noo tipo deste conversor. (Herdado de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Converte a cadeia de caracteres fornecida para o tipo deste conversor usando a cultura invariável e o contexto especificado. (Herdado de TypeConverter)
ConvertFromInvariantString(String)	Converte a cadeia de caracteres fornecida para o tipo deste conversor usando a cultura invariável. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Converte o texto fornecido em um objeto, usando o contexto e a informação de cultura especificados. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Converte o texto fornecido em um objeto, usando o contexto especificado. (Herdado de TypeConverter)
ConvertFromString(String)	Converte o texto especificado em um objeto. (Herdado de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte o objeto de valor especificado para o tipo de destino especificado.
ConvertTo(Object, Type)	Converte o objeto de valor especificado para o tipo especificado, usando os argumentos. (Herdado de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres que não varia de acordo com a cultura, usando o contexto especificado. (Herdado de TypeConverter)
ConvertToInvariantString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres invariável da cultura. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Converte o valor especificado em uma representação de cadeia de caracteres, usando as informações de contexto e cultura especificadas. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres, usando o contexto fornecido. (Herdado de TypeConverter)
ConvertToString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres. (Herdado de TypeConverter)
CreateInstance(IDictionary)	Recria um Object dado um conjunto de valores de propriedade do objeto. (Herdado de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Cria uma instância do tipo ao qual esse TypeConverter está associado, usando o contexto especificado, dado um conjunto de valores de propriedade para o objeto. (Herdado de TypeConverter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetConvertFromException(Object)	Retorna uma exceção a ser gerada quando uma conversão não puder ser executada. (Herdado de TypeConverter)
GetConvertToException(Object, Type)	Retorna uma exceção a ser gerada quando uma conversão não puder ser executada. (Herdado de TypeConverter)
GetCreateInstanceSupported()	Retorna se a alteração de um valor neste objeto requer uma chamada ao método CreateInstance(IDictionary) para criar um novo valor. (Herdado de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Retorna se a alteração de um valor neste objeto requer uma chamada para CreateInstance(IDictionary) para criar um novo valor, usando o contexto especificado. (Herdado de TypeConverter)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperties(ITypeDescriptorContext, Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto especificado. (Herdado de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto e os atributos especificados. (Herdado de TypeConverter)
GetProperties(Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor. (Herdado de TypeConverter)
GetPropertiesSupported()	Retorna se este objeto dá suporte a propriedades. (Herdado de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Retorna se este objeto é compatível com as propriedades, usando o contexto especificado. (Herdado de TypeConverter)
GetStandardValues()	Retorna uma coleção de valores padrão do contexto padrão para o tipo de dados para o qual esse conversor de tipo foi criado. (Herdado de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Obtém uma coleção de valores padrão para o tipo de dados para o qual este validador é projetado.
GetStandardValuesExclusive()	Retorna se a coleção de valores padrão retornada de GetStandardValues() é uma lista exclusiva. (Herdado de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Obtém um valor que indica se a lista de valores padrão retornados do método GetStandardValues() é uma lista exclusiva usando o contexto especificado.
GetStandardValuesSupported()	Retorna se este objeto dá suporte a um conjunto padrão de valores que podem ser escolhidos em uma lista. (Herdado de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Obtém um valor que indica se esse objeto dá suporte a um conjunto padrão de valores que podem ser escolhidos em uma lista usando o contexto especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsValid(ITypeDescriptorContext, Object)	Obtém um valor que indica se o valor de objeto fornecido é válido para este tipo.
IsValid(Object)	Retorna se o objeto de valor especificado é válido para esse tipo. (Herdado de TypeConverter)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SortProperties(PropertyDescriptorCollection, String[])	Classifica uma coleção de propriedades. (Herdado de TypeConverter)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)