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 mit dem Namen MyClassConverterdeklariert. In diesem Beispiel wird davon ausgegangen, dass an MyClassConverter anderer Stelle implementiert wurde. Die Klasse, die den Konverter () implementiert,MyClassConverter muss von der -Klasse erben TypeConverter .

[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 MyClasserstellt. Dann ruft es die Attribute für die -Klasse ab und gibt den Namen des typkonverters aus, der von verwendet wird 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

Hinweise

Die Klasse, die Sie für die Konvertierung verwenden, muss von erben 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 unter Basisklasse TypeConverter und Vorgehensweise: Implementieren eines Typkonverters.

Um einen Typkonverter für eine benutzerdefinierte Klasse einzurichten, die ein Typkonvertierungsverhalten für XAML bereitstellt, wenden Sie das TypeConverterAttribute Attribut auf Ihren Typ an. Das Argument des Attributs verweist auf Ihre Typkonverterimplementierung. Ihr Typkonverter sollte In der Lage sein, Werte aus einer Zeichenfolge zu akzeptieren, die für Attribute oder Initialisierungstext im XAML-Markup verwendet wird, und diese Zeichenfolge in den gewünschten Zieltyp zu konvertieren. Weitere Informationen finden Sie unter TypeConverter und XAML.

Anstelle der Anwendung auf alle Werte eines Typs kann das Verhalten eines Typkonverters für XAML auch für eine bestimmte Eigenschaft festgelegt werden. In diesem Fall wenden Sie TypeConverterAttribute auf die Eigenschaftsdefinition an (die äußere Definition, nicht die spezifischen get- und set-Definitionen).

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

Für komplexe XAML-Serialisierungsfälle, die zusätzlichen Zustand von der Objektlaufzeit erfordern, sollten Sie zusätzlich zu einem Typkonverter einen Wertserialisierer definieren und beide Unterstützungsklassen für Ihre benutzerdefinierten Typen oder benutzerdefinierten Member zuordnen. Weitere Informationen finden Sie unter ValueSerializer.

Konstruktoren

Felder

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• TypeConverter
• XAML-bezogene CLR-Attribute für benutzerdefinierte Typen und Bibliotheken
• Definieren benutzerdefinierter Typen für die Verwendung in .NET XAML-Diensten
• XAML-Dienste