TypeConverter Klas

Definitie

public ref class TypeConverter

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

public class TypeConverter

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

type TypeConverter = class

Public Class TypeConverter

Overname

Object

TypeConverter

Afgeleid

Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter

Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter

System.Activities.XamlIntegration.AssemblyReferenceConverter

System.Activities.XamlIntegration.DynamicUpdateMapConverter

System.Activities.XamlIntegration.DynamicUpdateMapItemConverter

Meer…

Kenmerken

ComVisibleAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een exemplaar van een typeconversieprogramma maakt en deze koppelt aan een klasse. De klasse die het conversieprogramma implementeert, MyClassConvertermoet overnemen van de TypeConverter klasse.

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

Wanneer u een eigenschap hebt met een opsomming, controleert u of een opsommingswaarde geldig is voordat u de eigenschap instelt. Het volgende codevoorbeeld vereist dat een aangeroepen MyPropertyEnum opsomming is gedeclareerd.

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($"{nameof(MyProperty)} is not valid");
        }
        // 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

Een ander gangbaar conversieprogrammagebruik is het converteren van een object naar een tekenreeks. In het volgende codevoorbeeld wordt de naam van de Color opgeslagen in de variabele cafgedrukt.

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

U kunt ook een typeconversieprogramma gebruiken om een waarde te converteren van de naam, zoals wordt weergegeven in het volgende codevoorbeeld.

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

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

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

In het volgende codevoorbeeld kunt u een typeconversieprogramma gebruiken om de set standaardwaarden af te drukken die door het object worden ondersteund.

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

Opmerkingen

Het meest voorkomende type converter is er een die converteert naar en van een tekstweergave. Het typeconversieprogramma voor een klasse is gebonden aan de klasse met een TypeConverterAttribute. Tenzij dit kenmerk wordt overschreven, gebruiken alle klassen die overnemen van deze klasse hetzelfde typeconversieprogramma als de basisklasse.

Klassen die zijn afgeleid van TypeConverter , worden vaak verwezen als onderdeel van de manier waarop een XAML-processor een kenmerk of initialisatietekstwaarde converteert uit markeringen (die inherent een tekenreeks is) en een object genereert voor een runtime-weergave. Auteurs van aangepaste typen die een typeconversiegedrag voor XAML willen ondersteunen, implementeren doorgaans een TypeConverter klasse die hun eigen unieke ConvertFrom gedrag van een tekenreeks ondersteunt. Dit gedrag maakt het mogelijk om typeconversie uit de tekenreeks die is opgegeven als een XAML-kenmerkwaarde en biedt een XAML-processor met de ondersteuning die nodig is om een object te maken op basis van de tekenreeks, zodat het object kan worden geproduceerd in een geparseerde objectgrafiek. Aangepaste typen of leden van aangepaste typen worden aangegeven door toe te passen op TypeConverterAttribute de definities, waarbij het kenmerk verwijst naar de aangepaste TypeConverter implementatie. Zie Type conversieprogramma's voor XAML-overzicht voor meer informatie.

Notities voor overnemers

Overnemen van TypeConverter om uw eigen conversievereisten te implementeren. Wanneer u deze klasse overschrijft, kunt u de volgende methoden overschrijven:

• Ter ondersteuning van conversie van aangepaste typen overschrijft u de CanConvertFrom(ITypeDescriptorContext, Type)methoden , CanConvertTo(ITypeDescriptorContext, Type)en ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) methoden.

• Als u typen wilt converteren die het object opnieuw moeten maken om de waarde ervan te wijzigen, overschrijft u de CreateInstance(ITypeDescriptorContext, IDictionary) en GetCreateInstanceSupported(ITypeDescriptorContext) methoden.

• Als u typen wilt converteren die eigenschappen ondersteunen, overschrijft u de GetProperties(ITypeDescriptorContext, Object, Attribute[]) en GetPropertiesSupported(ITypeDescriptorContext) methoden. Als de klasse die u converteert geen eigenschappen heeft en u eigenschappen moet implementeren, kunt u de TypeConverter.SimplePropertyDescriptor klasse gebruiken als basis voor het implementeren van de eigenschapsdescriptors. Wanneer u overdrat van TypeConverter.SimplePropertyDescriptor, moet u de GetValue(Object) en SetValue(Object, Object) methoden overschrijven.

• Als u typen wilt converteren die ondersteuning bieden voor standaardwaarden, overschrijft u de GetStandardValues(ITypeDescriptorContext)en GetStandardValuesExclusive(ITypeDescriptorContext)GetStandardValuesSupported(ITypeDescriptorContext)IsValid(ITypeDescriptorContext, Object) methoden.

Opmerking: uw afgeleide type kan worden gemarkeerd als internal of private, maar er kan een exemplaar van uw type worden gemaakt met de TypeDescriptor klasse. Schrijf geen onveilige code door ervan uit te gaan dat de aanroeper wordt vertrouwd. Stel dat bellers exemplaren van uw type in gedeeltelijke vertrouwensrelatie kunnen maken.

Voor meer informatie over typeconversieprogramma's voor algemene (niet-XAML)-doeleinden, zie How to: Implement a Type Converter or Generalized Type Conversion.

Zie ook

• TypeConverterAttribute
• PropertyDescriptorCollection
• TypeConverter.SimplePropertyDescriptor
• TypeConverter.StandardValuesCollection
• Overzicht van typeconversieprogramma's voor XAML
• XAML-gerelateerde CLR-kenmerken voor aangepaste typen en bibliotheken
• Definieerde aangepaste typen voor gebruik met .NET XAML Services
• Conceptuele documentatie voor NET XAML Services