TypeConverterAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ObjectModel.dll

Source:

TypeConverterAttribute.cs

Spécifie le type à utiliser comme convertisseur de l'objet auquel cet attribut est lié.

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

TypeConverterAttribute()	Initialise une nouvelle instance de la classe TypeConverterAttribute avec le convertisseur de type par défaut, qui est une chaîne vide ("").
TypeConverterAttribute(String)	Initialise une nouvelle instance de la classe TypeConverterAttribute en utilisant le nom de type spécifié comme étant le convertisseur de données pour l'objet auquel cet attribut est lié.
TypeConverterAttribute(Type)	Initialise une nouvelle instance de la classe TypeConverterAttribute en utilisant le type spécifié comme convertisseur de données pour l'objet auquel cet attribut est lié.

Champs

Default

Spécifie le type à utiliser comme convertisseur de l'objet auquel cet attribut est lié.

Propriétés

ConverterTypeName	Obtient le nom de type qualifié complet de Type à utiliser comme convertisseur pour l'objet auquel cet attribut est lié.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur indiquant si la valeur de l'objet donné est égale au TypeConverterAttribute en cours.
GetHashCode()	Retourne le code de hachage de cette instance.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

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