Freigeben über

TypeConverter-Klasse

  • Artikel

Stellt eine einheitliche Methode zum Konvertieren von Werttypen in andere Typen sowie zum Zugreifen auf Standardwerte und Untereigenschaften bereit.

Namespace: System.ComponentModel
Assembly: System (in system.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Class TypeConverter
'Usage
Dim instance As TypeConverter

[ComVisibleAttribute(true)] 
public class TypeConverter

[ComVisibleAttribute(true)] 
public ref class TypeConverter

/** @attribute ComVisibleAttribute(true) */ 
public class TypeConverter

ComVisibleAttribute(true) 
public class TypeConverter

Hinweise

Am häufigsten wird ein Konverter für die Konvertierung in und aus Textdarstellungen verwendet. Der Typkonverter für eine Klasse ist mit einer TypeConverterAttribute-Klasse an die Klasse gebunden. Sofern dieses Attribut nicht überschrieben wird, verwenden alle von dieser Klasse erbenden Klassen den gleichen Typkonverter wie die Basisklasse.

Hinweis

Greifen Sie nie direkt auf einen Typkonverter zu. Greifen Sie auf den entsprechenden Konverter stattdessen mithilfe der TypeDescriptor-Klasse zu. Weitere Informationen finden Sie in den verfügbaren Codebeispielen.

Hinweise für Erben Erben Sie von der TypeConverter-Klasse, um eigene Konvertierungsanforderungen zu implementieren. Wenn diese Klasse vererbt wird, können Sie folgende Methoden überschreiben:

Hinweis

Der abgeleitete Typ kann als internal oder private gekennzeichnet sein, aber mit der TypeDescriptor-Klasse kann eine Instanz der Klasse erstellt werden. Schreiben Sie keinen unsicheren Code, indem Sie annehmen, dass der Aufrufer vertrauenswürdig ist. Nehmen Sie stattdessen an, dass Aufrufer Instanzen des Typs unter teilweiser Vertrauenswürdigkeit erstellen können.

Weitere Informationen über Typkonverter finden Sie unter Gewusst wie: Implementieren eines Typkonverters oder Verallgemeinerte Typkonvertierung.

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Beispiel

Der folgende Code veranschaulicht, wie eine Instanz eines Typkonverters erstellt und an eine Klasse gebunden wird. Die MyClassConverter-Klasse, die den Konverter implementiert, muss von der TypeConverter-Klasse erben.

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

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

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

/** @attribute TypeConverter(MyClassConverter.class)
 */
public class MyClass
{
    // Insert code here.
} //MyClass

Wenn eine Eigenschaft über eine Enumeration verfügt, müssen Sie vor dem Festlegen einer Eigenschaft die Gültigkeit eines Enumerationswerts überprüfen. Für dieses Beispiel ist es erforderlich, dass eine Enumeration mit dem Namen MyPropertyEnum deklariert wurde.

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

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:
   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.
      }
   }

/** @property 
 */
public void set_MyProperty(MyPropertyEnum value)
{
    // Checks to see if the value passed is valid.
    if (!(TypeDescriptor.GetConverter(MyPropertyEnum.class.ToType()).
        IsValid(value))) {
        throw new ArgumentException();
    }
    // The value is valid. Insert code to set the property.
} //set_MyProperty

Typkonverter werden auch häufig für die Konvertierung von Objekten in Zeichenfolgen verwendet. Im folgenden Codebeispiel wird der in der Variablen c gespeicherte Name der Color-Struktur ausgegeben.

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

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

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

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

Sie können einen Typkonverter auch wie im folgenden Beispiel dargestellt verwenden, um den Namen eines Typs in einen Wert zu konvertieren.

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

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

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

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

Im folgenden Codebeispiel wird ein Typkonverter verwendet, um die Menge von Standardwerten auszugeben, die vom Objekt unterstützt werden.

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

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

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

IEnumerator e = TypeDescriptor.GetConverter(Color.class.ToType()).
    GetStandardValues().GetEnumerator();
while (e.MoveNext()) {
    Color c = (Color)e.get_Current();
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));
}

Vererbungshierarchie

System.Object
  System.ComponentModel.TypeConverter
     Abgeleitete Klassen

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TypeConverter-Member
System.ComponentModel-Namespace
TypeConverterAttribute
PropertyDescriptorCollection-Klasse
TypeConverter.SimplePropertyDescriptor
TypeConverter.StandardValuesCollection