TypeConverter Classe

Définition

public ref class TypeConverter

public class TypeConverter

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

type TypeConverter = class

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

Public Class TypeConverter

Héritage

Object

TypeConverter

Dérivé

Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter

Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter

System.Activities.XamlIntegration.AssemblyReferenceConverter

System.Activities.XamlIntegration.DynamicUpdateMapConverter

System.Activities.XamlIntegration.DynamicUpdateMapItemConverter

Plus…

Attributs

ComVisibleAttribute

Exemples

L’exemple de code suivant montre comment créer une instance d’un convertisseur de type et la lier à une classe. La classe qui implémente le convertisseur, MyClassConverter, doit hériter de la 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

Lorsque vous avez une propriété qui a une énumération, vérifiez si une valeur d’énumération est valide avant de définir la propriété. L’exemple de code suivant exige qu’une énumération appelée MyPropertyEnum ait été déclarée.

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();
       }
       // 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

Une autre utilisation courante du convertisseur de type consiste à convertir un objet en chaîne. L’exemple de code suivant imprime le nom du Color stocké dans la variable 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))

Vous pouvez également utiliser un convertisseur de type pour convertir une valeur à partir de son nom, comme indiqué dans l’exemple de code suivant.

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

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

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

Dans l’exemple de code suivant, vous pouvez utiliser un convertisseur de type pour imprimer l’ensemble de valeurs standard que l’objet prend en charge.

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

Remarques

Le plus souvent, un convertisseur convertit un type en représentation textuelle et vice versa. Le convertisseur de type pour une classe est lié à la classe avec un TypeConverterAttribute. À moins que cet attribut ne soit remplacé, toutes les classes qui héritent de cette classe utilisent le même convertisseur de type que la classe de base.

Les classes dérivées de TypeConverter sont souvent référencées dans le cadre de la façon dont un processeur XAML convertit un attribut ou une valeur de texte d’initialisation à partir du balisage (qui est intrinsèquement une chaîne) et génère un objet pour une représentation au moment de l’exécution. Les auteurs de types personnalisés qui ont l’intention de prendre en charge un comportement de conversion de type pour XAML implémentent généralement une TypeConverter classe qui prend en charge leur propre comportement unique ConvertFrom à partir d’une chaîne. Ce comportement permet la conversion de type à partir de la chaîne fournie en tant que valeur d’attribut XAML et fournit à un processeur XAML la prise en charge nécessaire pour créer un objet à partir de la chaîne, afin que l’objet puisse être produit dans un graphe d’objets analysé. Les types personnalisés ou les membres de types personnalisés sont indiqués en appliquant TypeConverterAttribute aux définitions, l’attribut référençant l’implémentation personnalisée TypeConverter . Pour plus d’informations, consultez Vue d’ensemble des convertisseurs de types pour XAML.

Notes pour les héritiers

Héritez de TypeConverter pour implémenter vos propres exigences de conversion. Lorsque vous héritez de cette classe, vous pouvez remplacer les méthodes suivantes :

• Pour prendre en charge la conversion de type personnalisé, remplacez les CanConvertFrom(ITypeDescriptorContext, Type)méthodes , CanConvertTo(ITypeDescriptorContext, Type), ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)et ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) .

• Pour convertir les types qui doivent recréer l’objet pour modifier sa valeur, remplacez les CreateInstance(ITypeDescriptorContext, IDictionary) méthodes et GetCreateInstanceSupported(ITypeDescriptorContext) .

• Pour convertir les types qui prennent en charge les propriétés, remplacez les GetProperties(ITypeDescriptorContext, Object, Attribute[]) méthodes et GetPropertiesSupported(ITypeDescriptorContext) . Si la classe que vous convertissez n’a pas de propriétés et que vous devez implémenter des propriétés, vous pouvez utiliser la TypeConverter.SimplePropertyDescriptor classe comme base pour implémenter les descripteurs de propriété. Lorsque vous héritez de TypeConverter.SimplePropertyDescriptor, vous devez remplacer les GetValue(Object) méthodes et SetValue(Object, Object) .

• Pour convertir des types qui prennent en charge des valeurs standard, remplacez les GetStandardValues(ITypeDescriptorContext)méthodes , GetStandardValuesExclusive(ITypeDescriptorContext)et GetStandardValuesSupported(ITypeDescriptorContext)IsValid(ITypeDescriptorContext, Object) .

Remarque : Votre type dérivé peut être marqué comme internal ou private, mais une instance de votre type peut être créée avec la TypeDescriptor classe . N’écrivez pas de code non sécurisé en supposant que l’appelant est approuvé. Supposons plutôt que les appelants puissent créer des instances de votre type en confiance partielle.

Pour plus d’informations sur les convertisseurs de types à des fins générales (non XAML), consultez Guide pratique pour implémenter un convertisseur de type ou uneconversion de type généralisée.

Constructeurs

Méthodes

S’applique à

Voir aussi

• TypeConverterAttribute
• PropertyDescriptorCollection
• TypeConverter.SimplePropertyDescriptor
• TypeConverter.StandardValuesCollection
• Vue d’ensemble des convertisseurs de types pour XAML
• Attributs CLR liés à XAML pour les types et bibliothèques personnalisés
• Définir des types personnalisés à utiliser avec les services XAML .NET
• Documentation conceptuelle des services NET XAML