TypeConverter Klasse

Definition

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

Vererbung

Object

TypeConverter

Abgeleitet

Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter

Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter

System.Activities.XamlIntegration.AssemblyReferenceConverter

System.Activities.XamlIntegration.DynamicUpdateMapConverter

System.Activities.XamlIntegration.DynamicUpdateMapItemConverter

Mehr …

Attribute

ComVisibleAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie eine Instanz eines Typkonverters erstellen und an eine Klasse binden. Die Klasse, die den Konverter implementiert, MyClassConvertermuss von der -Klasse erben 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

Wenn Sie über eine Eigenschaft mit einer Enumeration verfügen, überprüfen Sie, ob ein Enumerationswert gültig ist, bevor Sie die Eigenschaft festlegen. Das nächste Codebeispiel erfordert, dass eine Enumeration mit dem Namen MyPropertyEnum deklariert wurde.

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

Eine weitere häufige Verwendung von Typkonvertern besteht darin, ein Objekt in eine Zeichenfolge zu konvertieren. Im folgenden Codebeispiel wird der Name des Color in der Variablen cgespeicherten ausgegeben.

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

Sie können auch einen Typkonverter verwenden, um einen Wert aus seinem Namen zu konvertieren, wie im nächsten Codebeispiel gezeigt.

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)

Im folgenden Codebeispiel können Sie einen Typkonverter verwenden, um den Satz von Standardwerten auszudrucken, den das Objekt unterstützt.

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

Hinweise

Der häufigste Konvertertyp ist derjenige, der in und aus einer Textdarstellung konvertiert. Der Typkonverter für eine Klasse wird mit einem TypeConverterAttribute an die Klasse gebunden. Sofern dieses Attribut nicht überschrieben wird, verwenden alle Klassen, die von dieser Klasse erben, den gleichen Typkonverter wie die Basisklasse.

Von TypeConverter abgeleitete Klassen werden häufig als Teil der Art referenziert, wie ein XAML-Prozessor ein Attribut oder einen Initialisierungstextwert aus markup konvertiert (das inhärent eine Zeichenfolge ist) und ein Objekt für eine Laufzeitdarstellung generiert. Benutzerdefinierte Typautoren, die ein Typkonvertierungsverhalten für XAML unterstützen möchten, implementieren in der Regel eine TypeConverter Klasse, die ihr eigenes eindeutiges ConvertFrom Verhalten aus einer Zeichenfolge unterstützt. Dieses Verhalten ermöglicht die Typkonvertierung aus der als XAML-Attributwert bereitgestellten Zeichenfolge und stellt einem XAML-Prozessor die Unterstützung bereit, die zum Erstellen eines Objekts aus der Zeichenfolge erforderlich ist, sodass das Objekt in einem analysierten Objektgraphen erstellt werden kann. Benutzerdefinierte Typen oder Member von benutzerdefinierten Typen werden durch Anwenden TypeConverterAttribute auf die Definitionen angegeben, wobei das Attribut auf die benutzerdefinierte TypeConverter Implementierung verweist. Weitere Informationen finden Sie unter Übersicht über Typkonverter für XAML.

Hinweise für Vererber

Erben Sie von TypeConverter , um Ihre eigenen Konvertierungsanforderungen zu implementieren. Wenn Sie von dieser Klasse erben, können Sie die folgenden Methoden überschreiben:

• Um die benutzerdefinierte Typkonvertierung zu unterstützen, überschreiben Sie die CanConvertFrom(ITypeDescriptorContext, Type)Methoden , CanConvertTo(ITypeDescriptorContext, Type), ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)und ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) .

• Um Typen zu konvertieren, die das Objekt neu erstellen müssen, um seinen Wert zu ändern, überschreiben Sie die CreateInstance(ITypeDescriptorContext, IDictionary) Methoden und GetCreateInstanceSupported(ITypeDescriptorContext) .

• Um Typen zu konvertieren, die Eigenschaften unterstützen, überschreiben Sie die GetProperties(ITypeDescriptorContext, Object, Attribute[]) Methoden und GetPropertiesSupported(ITypeDescriptorContext) . Wenn die Klasse, die Sie konvertieren, keine Eigenschaften aufweist und Sie Eigenschaften implementieren müssen, können Sie die TypeConverter.SimplePropertyDescriptor -Klasse als Basis für die Implementierung der Eigenschaftendeskriptoren verwenden. Wenn Sie von erben TypeConverter.SimplePropertyDescriptor, müssen Sie die GetValue(Object) Methoden und SetValue(Object, Object) überschreiben.

• Um Typen zu konvertieren, die Standardwerte unterstützen, überschreiben Sie die GetStandardValues(ITypeDescriptorContext)Methoden , GetStandardValuesExclusive(ITypeDescriptorContext)und GetStandardValuesSupported(ITypeDescriptorContext)IsValid(ITypeDescriptorContext, Object) .

Hinweis: Ihr abgeleiteter Typ kann als internal oder privategekennzeichnet sein, aber eine Instanz Ihres Typs kann mit der TypeDescriptor -Klasse erstellt werden. Schreiben Sie keinen unsicheren Code, indem Sie davon ausgehen, dass der Aufrufer vertrauenswürdig ist. Nehmen Sie stattdessen an, dass Aufrufer Instanzen Ihres Typs in teilweiser Vertrauenswürdigkeit erstellen können.

Weitere Informationen zu Typkonvertern für allgemeine (nicht-XAML)-Zwecke finden Sie unter Vorgehensweise: Implementieren eines Typkonverters oder generalisierte Typkonvertierung.

Konstruktoren

Methoden

Gilt für:

Weitere Informationen

• TypeConverterAttribute
• PropertyDescriptorCollection
• TypeConverter.SimplePropertyDescriptor
• TypeConverter.StandardValuesCollection
• Übersicht über Typkonverter für XAML
• XAML-bezogene CLR-Attribute für benutzerdefinierte Typen und Bibliotheken
• Definieren benutzerdefinierter Typen für die Verwendung in .NET XAML-Diensten
• Konzeptionelle Dokumentation zu NET XAML Services