TypeConverter Classe

Definição

public ref class TypeConverter

[System.Runtime.InteropServices.ComVisible(true)]
public class TypeConverter

public class TypeConverter

[<System.Runtime.InteropServices.ComVisible(true)>]
type TypeConverter = class

type TypeConverter = class

Public Class TypeConverter

Herança

Object

TypeConverter

Derivado

Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter

Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter

System.Activities.XamlIntegration.AssemblyReferenceConverter

System.Activities.XamlIntegration.DynamicUpdateMapConverter

System.Activities.XamlIntegration.DynamicUpdateMapItemConverter

Mais…

Atributos

ComVisibleAttribute

Exemplos

O exemplo de código seguinte mostra como criar uma instância de um conversor de tipos e associá-la a uma classe. A classe que implementa o conversor, MyClassConverter, deve herdar da TypeConverter classe.

public:
   [TypeConverter(Sample::MyClassConverter::typeid)]
   ref class MyClass
   {
      // Insert code here.
   };

[TypeConverter(typeof(MyClassConverter))]
public class MyClass
{
    // Insert code here.
}

<TypeConverter(GetType(MyClassConverter))> _
Public Class Class1
    ' Insert code here.
End Class

Quando tem uma propriedade que tem uma enumeração, verifique se um valor de enumeração é válido antes de definir a propriedade. O próximo exemplo de código exige que uma enumeração chamada MyPropertyEnum tenha sido declarada.

public:
   property MyPropertyEnum MyProperty 
   {
      void set( MyPropertyEnum value )
      {
         // Checks to see if the value passed is valid.
         if ( !TypeDescriptor::GetConverter( MyPropertyEnum::typeid )->IsValid( value ) )
         {
            throw gcnew ArgumentException;
         }
         // The value is valid. Insert code to set the property.
      }
   }

public MyPropertyEnum MyProperty
{
    set
    {
        // Checks to see if the value passed is valid.
        if (!TypeDescriptor.GetConverter(typeof(MyPropertyEnum)).IsValid(value))
        {
            throw new ArgumentException($"{nameof(MyProperty)} is not valid");
        }
        // The value is valid. Insert code to set the property.
    }
}

Public WriteOnly Property MyProperty() As MyPropertyEnum
    Set
        ' Checks to see if the value passed is valid.
        If Not TypeDescriptor.GetConverter(GetType(MyPropertyEnum)).IsValid(value) Then
            Throw New ArgumentException()
        End If
        ' The value is valid. Insert code to set the property.
    End Set 
End Property

Outro uso comum de conversores de tipos é converter um objeto numa cadeia. O seguinte exemplo de código imprime o nome do Color armazenado na variável c.

Color c = Color::Red;
Console::WriteLine( TypeDescriptor::GetConverter( c )->ConvertToString( c ) );

Color c = Color.Red;
Console.WriteLine(TypeDescriptor.GetConverter(typeof(Color)).ConvertToString(c));

Dim c As Color = Color.Red
Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c))

Também pode usar um conversor de tipos para converter um valor do seu nome, como mostrado no próximo exemplo de código.

Color c =  (Color)(TypeDescriptor::GetConverter( Color::typeid )->ConvertFromString( "Red" ));

(Color)TypeDescriptor.GetConverter(typeof(Color)).ConvertFromString("Red");

Dim c As Color = CType(TypeDescriptor.GetConverter(GetType(Color)).ConvertFromString("Red"), Color)

No exemplo de código seguinte, pode usar um conversor de tipos para imprimir o conjunto de valores padrão que o objeto suporta.

for each ( Color c in TypeDescriptor::GetConverter( Color::typeid )->GetStandardValues() )
{
   Console::WriteLine( TypeDescriptor::GetConverter( c )->ConvertToString( c ) );
}

foreach (Color c in TypeDescriptor.GetConverter(typeof(Color)).GetStandardValues())
{
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));
}

Dim c As Color
For Each c In  TypeDescriptor.GetConverter(GetType(Color)).GetStandardValues()
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c))
Next c

Observações

O tipo mais comum de conversor é aquele que converte de e para uma representação de texto. O conversor de tipo para uma classe está associado a ela através de um TypeConverterAttribute. A menos que esse atributo seja substituído, todas as classes que herdam dessa classe usam o mesmo conversor de tipo que a classe base.

As classes derivadas de TypeConverter são frequentemente referenciadas como parte de como um processador XAML converte um atributo ou valor de texto de inicialização a partir de uma marcação (que é inerentemente uma cadeia) e gera um objeto para uma representação em tempo de execução. Autores de tipos personalizados que pretendem suportar um comportamento de conversão de tipos para XAML normalmente implementam uma TypeConverter classe que suporta o seu próprio comportamento único ConvertFrom a partir de uma cadeia. Este comportamento permite a conversão de tipos a partir da string fornecida como valor de atributo XAML e fornece a um processador XAML o suporte necessário para criar um objeto a partir da string, de modo a que o objeto possa ser produzido num grafo de objetos analisado. Os tipos personalizados ou membros dos tipos personalizados são indicados aplicando TypeConverterAttribute às definições, com o atributo a referenciar a implementação personalizada TypeConverter . Para mais informações, consulte Conversores de Tipos para Visão Geral XAML.

Notas para Herdeiros

Herde para TypeConverter implementar os seus próprios requisitos de conversão. Quando herdas desta classe, podes sobrepor os seguintes métodos:

• Para suportar a conversão de tipos personalizados, substitua os CanConvertFrom(ITypeDescriptorContext, Type)métodos , CanConvertTo(ITypeDescriptorContext, Type), ConvertFrom(ITypeDescriptorContext, CultureInfo, Object), e ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) .

• Para converter tipos que precisam de recriar o objeto para alterar o seu valor, substitua os CreateInstance(ITypeDescriptorContext, IDictionary) métodos e.GetCreateInstanceSupported(ITypeDescriptorContext)

• Para converter tipos que suportam propriedades, sobrescrita os GetProperties(ITypeDescriptorContext, Object, Attribute[]) métodos and GetPropertiesSupported(ITypeDescriptorContext) . Se a classe que estás a converter não tiver propriedades e precisares de implementar propriedades, podes usar a TypeConverter.SimplePropertyDescriptor classe como base para implementar os descritores de propriedades. Quando herdas de TypeConverter.SimplePropertyDescriptor, tens de sobrescrever os GetValue(Object) métodos e SetValue(Object, Object) .

• Para converter tipos que suportam valores padrão, substitua os GetStandardValues(ITypeDescriptorContext)métodos , GetStandardValuesExclusive(ITypeDescriptorContext), GetStandardValuesSupported(ITypeDescriptorContext) e IsValid(ITypeDescriptorContext, Object) .

Nota: O seu tipo derivado pode estar marcado como internal ou private, mas uma instância do seu tipo pode ser criada com a TypeDescriptor classe. Não escreva código inseguro assumindo que o chamador é confiável. Assuma, em vez disso, que os chamadores podem criar instâncias do seu tipo em confiança parcial.

Para mais informações sobre conversores de tipos para fins gerais (não XAML), veja Como: Implementar um Conversor de Tipos ou Conversão de Tipos Generalizada.

Ver também

• TypeConverterAttribute
• PropertyDescriptorCollection
• TypeConverter.SimplePropertyDescriptor
• TypeConverter.StandardValuesCollection
• Visão geral dos conversores de tipos para XAML
• Atributos CLR relacionados com XAML para tipos e bibliotecas personalizados
• Defina tipos personalizados para uso com .NET Serviços XAML
• Documentação Conceptual dos Serviços NET XAML