TypeConverterAttribute Classe

Définition

public ref class TypeConverterAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class TypeConverterAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type TypeConverterAttribute = class
    inherit Attribute

Public NotInheritable Class TypeConverterAttribute
Inherits Attribute

Héritage

Object

Attribute

TypeConverterAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant déclare MyClass utiliser le convertisseur de type appelé MyClassConverter. Cet exemple part du principe que MyClassConverter l’implémentation a été effectuée ailleurs. La classe qui implémente le convertisseur (MyClassConverter) doit hériter de la TypeConverter classe.

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

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

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

L’exemple suivant crée une instance de MyClass. Ensuite, il obtient les attributs de la classe et imprime le nom du convertisseur de type utilisé par MyClass.

int main()
{
   // Creates a new instance of MyClass.
   Class1::MyClass^ myNewClass = gcnew Class1::MyClass;

   // Gets the attributes for the instance.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewClass );

   /* Prints the name of the type converter by retrieving the 
        * TypeConverterAttribute from the AttributeCollection. */
   TypeConverterAttribute^ myAttribute = dynamic_cast<TypeConverterAttribute^>(attributes[ TypeConverterAttribute::typeid ]);
   Console::WriteLine( "The type converter for this class is: {0}", myAttribute->ConverterTypeName );
   return 0;
}

public static int Main()
{
    // Creates a new instance of MyClass.
    MyClass myNewClass = new();

    // Gets the attributes for the instance.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewClass);

    /* Prints the name of the type converter by retrieving the 
     * TypeConverterAttribute from the AttributeCollection. */
    TypeConverterAttribute myAttribute =
        (TypeConverterAttribute)attributes[typeof(TypeConverterAttribute)];

    Console.WriteLine("The type conveter for this class is: " +
        myAttribute.ConverterTypeName);

    return 0;
}

Public Shared Function Main() As Integer
    ' Creates a new instance of ClassA.
    Dim myNewClass As New ClassA()
    
    ' Gets the attributes for the instance.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewClass)
    
    ' Prints the name of the type converter by retrieving the
    ' TypeConverterAttribute from the AttributeCollection. 
    Dim myAttribute As TypeConverterAttribute = _
        CType(attributes(GetType(TypeConverterAttribute)), TypeConverterAttribute)
    
    Console.WriteLine(("The type conveter for this class is: " _
        + myAttribute.ConverterTypeName))
    Return 0
End Function 'Main

Remarques

La classe que vous utilisez pour la conversion doit hériter de TypeConverter. Utilisez la ConverterTypeName propriété pour obtenir le nom de la classe qui fournit la conversion de données pour l’objet auquel cet attribut est lié.

Pour plus d’informations sur les attributs, consultez Attributs. Pour plus d’informations sur les convertisseurs de types, consultez la TypeConverter classe de base et How to : Implement a Type Converter.

Pour établir un convertisseur de type sur une classe personnalisée qui fournit un comportement de conversion de type pour XAML, vous appliquez l’attribut TypeConverterAttribute à votre type. L’argument de l’attribut fait référence à votre implémentation de convertisseur de type. Votre convertisseur de type doit être en mesure d’accepter des valeurs d’une chaîne utilisée pour les attributs ou le texte d’initialisation dans le balisage XAML et de convertir cette chaîne en votre type de destination prévu. Pour plus d’informations, consultez TypeConverters et XAML.

Au lieu d’appliquer à toutes les valeurs d’un type, un comportement de convertisseur de type pour XAML peut également être établi sur une propriété spécifique. Dans ce cas, vous appliquez TypeConverterAttribute la définition de propriété (la définition externe, et non les définitions spécifiquesget).set

Un comportement de convertisseur de type pour l’utilisation XAML d’un membre pouvant être attaché personnalisé peut être affecté en appliquant TypeConverterAttribute à l’accesseur get de méthode qui prend en charge l’utilisation XAML. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.

Pour les cas de sérialisation XAML complexes nécessitant un état supplémentaire à partir du runtime d’objet, envisagez de définir un sérialiseur de valeurs en plus d’un convertisseur de types et d’attributs qui prennent en charge les classes sur vos types personnalisés ou membres personnalisés. Pour plus d’informations, consultez ValueSerializer.

Voir aussi

• TypeConverter
• Attributs CLR liés au code XAML pour les types et bibliothèques personnalisés
• Définir des types personnalisés à utiliser avec les services XAML .NET
• XAML Services