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 suppose que a MyClassConverter été implémenté ailleurs. La classe implémentant 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 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 = 
        (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 type, 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 les 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 type de destination prévu. Pour plus d’informations, consultez TypeConverters et XAML.

Au lieu de s’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 et set spécifiquesget).

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

Pour les cas de sérialisation XAML complexes qui nécessitent un état supplémentaire du runtime d’objet, envisagez de définir un sérialiseur de valeur en plus d’un convertisseur de type et d’attribuer les deux classes de prise en charge sur vos types personnalisés ou membres personnalisés. Pour plus d'informations, consultez ValueSerializer.

Constructeurs

Champs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

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