TypeConverterAttribute Класс

Определение

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

Наследование

Object

Attribute

TypeConverterAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере объявляется MyClass использование преобразователя MyClassConverterтипов. В этом примере предполагается, что MyClassConverter он реализован в другом месте. Класс, реализуя преобразователь (MyClassConverter), должен наследоваться от 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

В следующем примере создается экземпляр MyClass. Затем он получает атрибуты для класса и выводит имя преобразователя типов, используемого 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

Комментарии

Класс, используемый для преобразования, должен наследоваться от TypeConverter. ConverterTypeName Используйте свойство, чтобы получить имя класса, который предоставляет преобразование данных для объекта, к которому привязан этот атрибут.

Дополнительные сведения об атрибутах см. в разделе "Атрибуты". Дополнительные сведения о преобразователях типов см. в базовом TypeConverter классе и инструкции. Реализация преобразователя типов.

Чтобы установить преобразователь типов для пользовательского класса, который обеспечивает поведение преобразования типов для XAML, атрибут применяется к типу TypeConverterAttribute . Аргумент атрибута ссылается на реализацию преобразователя типов. Преобразователь типов должен иметь возможность принимать значения из строки, используемой для атрибутов или текста инициализации в разметке XAML, и преобразовать эту строку в предполагаемый тип назначения. Дополнительные сведения см. в разделе TypeConverters и XAML.

Вместо применения ко всем значениям типа можно также установить поведение преобразователя типов для XAML для определенного свойства. В этом случае применяется TypeConverterAttribute к определению свойства (внешнему определению, а не к конкретным get и set определениям).

Поведение преобразователя типов для использования пользовательского присоединенного члена XAML можно назначить, применяя TypeConverterAttribute к методу get доступа, поддерживающему использование XAML. Дополнительные сведения см. в разделе "Общие сведения о присоединенных свойствах".

Для сложных случаев сериализации XAML, требующих дополнительного состояния из среды выполнения объекта, рассмотрите возможность определения сериализатора значений в дополнение к преобразователю типов и атрибутам как для пользовательских типов, так и для пользовательских элементов. Дополнительные сведения см. в разделе ValueSerializer.

См. также раздел

• TypeConverter
• Атрибуты среды CLR, связанные с XAML, для пользовательских типов и библиотек
• Определение настраиваемых типов для использования со службами XAML .NET
• Службы XAML