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 svázat ji s třídou. 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, před nastavením vlastnosti zkontrolujte, zda je hodnota výčtu platná. Další příklad kódu vyžaduje, aby byl deklarován volaný MyPropertyEnum výčet.

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 využitím převaděče typů je převedení objektu na řetězec. Následující příklad kódu vypíše 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 také použít k převodu hodnoty z jejího názvu, jak je znázorněno v další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í textovou hodnotu atributu nebo inicializace ze značek (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 typů 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 parsovaného grafu objektů. Vlastní typy nebo členy vlastních typů se označují použitím TypeConverterAttribute definic 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), aConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type).

• Chcete-li převést typy, které musí znovu vytvořit objekt, 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 použít TypeConverter.SimplePropertyDescriptor 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) aIsValid(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í můžou vytvářet instance vašeho typu v částečném vztahu důvěryhodnosti.

Další informace o převaděčích typů pro obecné účely (bez 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