TypeConverter Třída

Definice

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

Dědičnost

Object

TypeConverter

Odvozené

Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter

Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter

System.Activities.XamlIntegration.AssemblyReferenceConverter

System.Activities.XamlIntegration.DynamicUpdateMapConverter

System.Activities.XamlIntegration.DynamicUpdateMapItemConverter

Více…

Atributy

ComVisibleAttribute

Příklady

Následující příklad kódu ukazuje, jak vytvořit instanci převaděče typů a vytvořit vazbu na třídu. Třída implementuje převaděč , MyClassConvertermusí dědit z TypeConverter třídy .

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

Pokud máte vlastnost, která má výčet, zkontrolujte, zda je hodnota výčtu platná před nastavením vlastnosti. Další příklad kódu vyžaduje, aby byl deklarován výčet s názvem 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

Dalším běžným použitím převaděče typů je převedení objektu na řetězec. Následující příklad kódu vytiskne název uloženého Color v proměnné 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))

Převaděč typů můžete použít také k převodu hodnoty z jejího názvu, jak je znázorněno v následujícím příkladu kódu.

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)

V následujícím příkladu kódu můžete pomocí převaděče typů vytisknout sadu standardních hodnot, které objekt podporuje.

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

Poznámky

Nejběžnějším typem převaděče je ten, který převádí na a z textové reprezentace. Převaděč typů pro třídu je vázán na třídu pomocí TypeConverterAttribute. Pokud není tento atribut přepsán, všechny třídy, které dědí z této třídy, používají stejný převaděč typů jako základní třída.

Na třídy odvozené z TypeConverter se často odkazuje jako součást toho, jak procesor XAML převádí atribut nebo textovou hodnotu inicializace z kódu (což je ze své podstaty řetězec) a generuje objekt pro reprezentaci za běhu. Autoři vlastních typů, kteří mají v úmyslu podporovat chování převodu typů pro XAML, obvykle implementují TypeConverter třídu, která podporuje jejich vlastní jedinečné ConvertFrom chování z řetězce. Toto chování umožňuje převod typu z řetězce zadaného jako hodnota atributu XAML a poskytuje procesoru XAML podporu potřebnou k vytvoření objektu z řetězce, aby bylo možné objekt vytvořit v grafu analyzovaného objektu. Vlastní typy nebo členy vlastních typů jsou označeny použitím TypeConverterAttribute na definice s atributem odkazujícím na vlastní TypeConverter implementaci. Další informace najdete v tématu Přehled převaděčů typů pro XAML.

Poznámky pro dědice

Dědit z TypeConverter a implementovat vlastní požadavky na převod. Když dědíte z této třídy, můžete přepsat následující metody:

• Pokud chcete podporovat převod vlastního CanConvertFrom(ITypeDescriptorContext, Type)typu, přepište metody , CanConvertTo(ITypeDescriptorContext, Type)ConvertFrom(ITypeDescriptorContext, CultureInfo, Object), a ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) .

• Chcete-li převést typy, které musí objekt znovu vytvořit, aby se změnila jeho hodnota, přepište CreateInstance(ITypeDescriptorContext, IDictionary) metody a GetCreateInstanceSupported(ITypeDescriptorContext) .

• Chcete-li převést typy, které podporují vlastnosti, přepište GetProperties(ITypeDescriptorContext, Object, Attribute[]) metody a GetPropertiesSupported(ITypeDescriptorContext) . Pokud třída, kterou převádíte, nemá vlastnosti a potřebujete implementovat vlastnosti, můžete TypeConverter.SimplePropertyDescriptor použít třídu jako základ pro implementaci popisovačů vlastností. Když dědíte z TypeConverter.SimplePropertyDescriptor, musíte přepsat GetValue(Object) metody a SetValue(Object, Object) .

• Chcete-li převést typy, které podporují standardní hodnoty, přepište GetStandardValues(ITypeDescriptorContext)metody , GetStandardValuesExclusive(ITypeDescriptorContext)GetStandardValuesSupported(ITypeDescriptorContext) a IsValid(ITypeDescriptorContext, Object) .

Poznámka: Odvozený typ může být označený jako internal nebo private, ale instanci vašeho typu lze vytvořit pomocí TypeDescriptor třídy . Nezabezpečený kód nezapisujte za předpokladu, že je volající důvěryhodný. Předpokládejme místo toho, že volající mohou vytvářet instance vašeho typu v částečném vztahu důvěryhodnosti.

Další informace o převaděčích typů pro obecné účely (mimo XAML) najdete v tématu Postupy: Implementace převaděče typů nebo Převod generalizovaného typu.

Konstruktory

Metody

Platí pro

Viz také

• TypeConverterAttribute
• PropertyDescriptorCollection
• TypeConverter.SimplePropertyDescriptor
• TypeConverter.StandardValuesCollection
• Přehled převaděčů typů pro XAML
• Atributy CLR související s XAML pro vlastní typy a knihovny
• Definování vlastních typů pro použití se službami .NET XAML
• Koncepční dokumentace ke službám NET XAML