TypeConverterAttribute Klasse

Definition

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

Vererbung

Object

Attribute

TypeConverterAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird die Verwendung des Typkonverters MyClass deklariert, der aufgerufen wird MyClassConverter. In diesem Beispiel wird davon ausgegangen, dass sie MyClassConverter an anderer Stelle implementiert wurde. Die Klasse, die den Konverter implementiert (MyClassConverter) muss von der TypeConverter Klasse erben.

[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

Im nächsten Beispiel wird eine Instanz von MyClass. Anschließend ruft es die Attribute für die Klasse ab und druckt den Namen des typkonverters, von MyClassdem verwendet wird.

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

Hinweise

Die Klasse, die Sie für die Konvertierung verwenden, muss von TypeConverter. Verwenden Sie die ConverterTypeName Eigenschaft, um den Namen der Klasse abzurufen, die die Datenkonvertierung für das Objekt bereitstellt, an das dieses Attribut gebunden ist.

Weitere Informationen zu Attributen finden Sie unter "Attribute". Weitere Informationen zu Typkonvertern finden Sie in der TypeConverter Basisklasse und vorgehensweise: Implementieren eines Typkonverters.

Um einen Typkonverter für eine benutzerdefinierte Klasse einzurichten, die das Typkonvertierungsverhalten für XAML bereitstellt, wenden Sie das TypeConverterAttribute Attribut auf Ihren Typ an. Das Argument des Attributs verweist auf die Typkonverterimplementierung. Ihr Typkonverter sollte Werte aus einer Zeichenfolge akzeptieren können, die für Attribute oder Initialisierungstext im XAML-Markup verwendet wird, und diese Zeichenfolge in Ihren beabsichtigten Zieltyp konvertieren können. Weitere Informationen finden Sie unter TypeConverters und XAML.

Anstatt auf alle Werte eines Typs anzuwenden, kann ein Typkonverterverhalten für XAML auch für eine bestimmte Eigenschaft festgelegt werden. In diesem Fall gelten Sie für TypeConverterAttribute die Eigenschaftsdefinition (die äußere Definition, nicht die spezifischen get und set Definitionen).

Ein Typkonverterverhalten für die XAML-Verwendung eines benutzerdefinierten anfügenden Elements kann zugewiesen werden, indem er auf den Methodenaccessor angewendet TypeConverterAttribute wird, der get die XAML-Verwendung unterstützt. Weitere Informationen finden Sie unter "Übersicht über angefügte Eigenschaften".

Bei komplexen XAML-Serialisierungsfällen, die zusätzlichen Zustand aus der Objektlaufzeit erfordern, sollten Sie zusätzlich zu einem Typkonverter einen Wert serialisierer definieren und beide Unterstützungsklassen für Ihre benutzerdefinierten Typen oder benutzerdefinierten Member attributieren. Weitere Informationen finden Sie unter ValueSerializer.

Weitere Informationen

• TypeConverter
• XAML-bezogene CLR-Attribute für benutzerdefinierte Typen und Bibliotheken
• Definieren von benutzerdefinierten Typen für die Verwendung mit .NET XAML Services
• XAML-Dienste