TypeConverterAttribute Clase

Definición

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

Herencia

Object

Attribute

TypeConverterAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se declara MyClass para usar el convertidor de tipos denominado MyClassConverter. En este ejemplo se supone que MyClassConverter se ha implementado en otro lugar. La clase que implementa el convertidor (MyClassConverter) debe heredar de la TypeConverter clase .

[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

En el ejemplo siguiente se crea una instancia de MyClass. A continuación, obtiene los atributos de la clase e imprime el nombre del convertidor de tipos usado por 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

Comentarios

La clase que se usa para la conversión debe heredar de TypeConverter. Use la ConverterTypeName propiedad para obtener el nombre de la clase que proporciona la conversión de datos para el objeto al que está enlazado este atributo.

Para obtener más información sobre los atributos, vea Atributos. Para obtener más información sobre los convertidores de tipos, vea la TypeConverter clase base y How to: Implement a Type Converter.

Para establecer un convertidor de tipos en una clase personalizada que proporciona el comportamiento de conversión de tipos para XAML, aplicas el TypeConverterAttribute atributo al tipo. El argumento del atributo hace referencia a la implementación del convertidor de tipos. El convertidor de tipos debe ser capaz de aceptar valores de una cadena que se usa para atributos o texto de inicialización en marcado XAML y convertir esa cadena en el tipo de destino previsto. Para obtener más información, consulta TypeConverters y XAML.

En lugar de aplicar a todos los valores de un tipo, también se puede establecer un comportamiento de convertidor de tipos para XAML en una propiedad específica. En este caso, se aplica TypeConverterAttribute a la definición de propiedad (la definición externa, no a las definiciones y set específicasget).

Se puede asignar un comportamiento de convertidor de tipos para el uso xaml de un miembro adjuntable personalizado aplicando TypeConverterAttribute al descriptor de acceso de get método que admite el uso de XAML. Para obtener más información, vea Información general sobre las propiedades adjuntas.

En el caso de casos complejos de serialización XAML que requieren un estado adicional del tiempo de ejecución del objeto, considere la posibilidad de definir un serializador de valores además de un convertidor de tipos y el atributo admiten clases en los tipos personalizados o miembros personalizados. Para obtener más información, consulte ValueSerializer.

Consulte también

• TypeConverter
• Atributos CLR relacionados con XAML para tipos y bibliotecas personalizados
• Definición de tipos personalizados para su uso con servicios XAML de .NET
• Servicios XAML