TypeConverter Класс

Определение

public ref class TypeConverter

public class TypeConverter

[System.Runtime.InteropServices.ComVisible(true)]
public class TypeConverter

type TypeConverter = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type TypeConverter = class

Public Class TypeConverter

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

Object

TypeConverter

Производный

Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter

Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter

System.Activities.XamlIntegration.AssemblyReferenceConverter

System.Activities.XamlIntegration.DynamicUpdateMapConverter

System.Activities.XamlIntegration.DynamicUpdateMapItemConverter

Подробнее…

Атрибуты

ComVisibleAttribute

Примеры

В следующем примере кода показано, как создать экземпляр преобразователя типов и привязать его к классу . Класс, реализуя преобразователь , MyClassConverterдолжен наследовать от TypeConverter класса .

public:
   [TypeConverter(Sample::MyClassConverter::typeid)]
   ref class MyClass
   {
      // Insert code here.
   };

[TypeConverter(typeof(MyClassConverter))]
 public class MyClass {
    // Insert code here.
}

<TypeConverter(GetType(MyClassConverter))> _
Public Class Class1
    ' Insert code here.
End Class

Если у вас есть свойство с перечислением, проверьте, является ли значение перечисления допустимым, прежде чем задавать свойство . В следующем примере кода требуется, чтобы был объявлен перечисление с именем MyPropertyEnum .

public:
   property MyPropertyEnum MyProperty 
   {
      void set( MyPropertyEnum value )
      {
         // Checks to see if the value passed is valid.
         if ( !TypeDescriptor::GetConverter( MyPropertyEnum::typeid )->IsValid( value ) )
         {
            throw gcnew ArgumentException;
         }
         // The value is valid. Insert code to set the property.
      }
   }

public MyPropertyEnum MyProperty {
    set {
       // Checks to see if the value passed is valid.
       if (!TypeDescriptor.GetConverter(typeof(MyPropertyEnum)).IsValid(value)) {
          throw new ArgumentException();
       }
       // The value is valid. Insert code to set the property.
    }
 }

Public WriteOnly Property MyProperty() As MyPropertyEnum
    Set
        ' Checks to see if the value passed is valid.
        If Not TypeDescriptor.GetConverter(GetType(MyPropertyEnum)).IsValid(value) Then
            Throw New ArgumentException()
        End If
        ' The value is valid. Insert code to set the property.
    End Set 
End Property

Еще одним распространенным использованием преобразователя типов является преобразование объекта в строку. В следующем примере кода выводится имя объекта , хранящегося Color в переменной c.

Color c = Color::Red;
Console::WriteLine( TypeDescriptor::GetConverter( c )->ConvertToString( c ) );

Color c = Color.Red;
    Console.WriteLine(TypeDescriptor.GetConverter(typeof(Color)).ConvertToString(c));

Dim c As Color = Color.Red
Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c))

Преобразователь типов также можно использовать для преобразования значения из его имени, как показано в следующем примере кода.

Color c =  (Color)(TypeDescriptor::GetConverter( Color::typeid )->ConvertFromString( "Red" ));

Color c = (Color)TypeDescriptor.GetConverter(typeof(Color)).ConvertFromString("Red");

Dim c As Color = CType(TypeDescriptor.GetConverter(GetType(Color)).ConvertFromString("Red"), Color)

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

for each ( Color c in TypeDescriptor::GetConverter( Color::typeid )->GetStandardValues() )
{
   Console::WriteLine( TypeDescriptor::GetConverter( c )->ConvertToString( c ) );
}

foreach(Color c in TypeDescriptor.GetConverter(typeof(Color)).GetStandardValues()) {
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));
 }

Dim c As Color
For Each c In  TypeDescriptor.GetConverter(GetType(Color)).GetStandardValues()
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c))
Next c

Комментарии

Самый распространенный тип преобразователя — тот, который преобразует в текстовое представление и из него. Преобразователь типов для класса привязывается к классу с помощью TypeConverterAttribute. Если этот атрибут не переопределен, все классы, наследующие от этого класса, используют тот же преобразователь типов, что и базовый класс.

На классы, производные от TypeConverter , часто ссылаются как на то, как обработчик XAML преобразует атрибут или текстовое значение инициализации из разметки (которая по сути является строкой) и создает объект для представления во время выполнения. Авторы пользовательских типов, которые намерены поддерживать поведение преобразования типов для XAML, обычно реализуют TypeConverter класс, поддерживающий собственное уникальное ConvertFrom поведение из строки. Такое поведение позволяет преобразовать тип из строки, предоставленной в качестве значения атрибута XAML, и предоставляет обработчику XAML поддержку, необходимую для создания объекта из строки, чтобы объект мог быть создан в проанализированном графе объекта. Настраиваемые типы или члены настраиваемых типов указываются путем применения TypeConverterAttribute к определениям, при этом атрибут ссылается на пользовательскую TypeConverter реализацию. Дополнительные сведения см. в статье Общие сведения о преобразователях типов для XAML.

Примечания для тех, кто наследует этот метод

Наследование от TypeConverter для реализации собственных требований к преобразованию. При наследовании от этого класса можно переопределить следующие методы:

• Чтобы поддерживать преобразование пользовательских типов, переопределите CanConvertFrom(ITypeDescriptorContext, Type)методы , CanConvertTo(ITypeDescriptorContext, Type), ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)и ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) .

• Чтобы преобразовать типы, которые должны повторно создать объект для изменения его значения, переопределите CreateInstance(ITypeDescriptorContext, IDictionary) методы и GetCreateInstanceSupported(ITypeDescriptorContext) .

• Чтобы преобразовать типы, поддерживающие свойства, переопределите GetProperties(ITypeDescriptorContext, Object, Attribute[]) методы и GetPropertiesSupported(ITypeDescriptorContext) . Если преобразуемый класс не имеет свойств и необходимо реализовать свойства, можно использовать TypeConverter.SimplePropertyDescriptor класс в качестве основы для реализации дескрипторов свойств. При наследовании от TypeConverter.SimplePropertyDescriptorнеобходимо переопределить методы GetValue(Object) и SetValue(Object, Object) .

• Чтобы преобразовать типы, поддерживающие стандартные значения, переопределите GetStandardValues(ITypeDescriptorContext)методы , GetStandardValuesExclusive(ITypeDescriptorContext)GetStandardValuesSupported(ITypeDescriptorContext) и IsValid(ITypeDescriptorContext, Object) .

Примечание. Производный тип может быть помечен как internal или private, но экземпляр типа можно создать с TypeDescriptor помощью класса . Не записывайте небезопасный код, предполагая, что вызывающий объект является доверенным. Вместо этого предположим, что вызывающие объекты могут создавать экземпляры типа с частичным доверием.

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

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

Методы

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

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

• TypeConverterAttribute
• PropertyDescriptorCollection
• TypeConverter.SimplePropertyDescriptor
• TypeConverter.StandardValuesCollection
• Общие сведения о преобразователях типов для XAML
• Атрибуты CLR, связанные с XAML, для пользовательских типов и библиотек
• Определение пользовательских типов для использования со службами XAML .NET
• Концептуальная документация по службам NET XAML