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 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

Комментарии

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

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

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

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

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

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

Конструкторы

Поля

Свойства

Методы

Явные реализации интерфейса

Применяется к

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

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