TypeConverter.ConvertTo Methode

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Konvertiert das angegebene Wertobjekt in den angegebenen Typ.

Überlädt

ConvertTo(Object, Type)	Konvertiert das angegebene Wertobjekt unter Verwendung der Argumente in den angegebenen Typ.
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Konvertiert das angegebene Wertobjekt in den angegebenen Typ mit dem angegebenen Kontext und Kulturinformationen.

ConvertTo(Object, Type)

Quelle:

TypeConverter.cs

Konvertiert das angegebene Wertobjekt unter Verwendung der Argumente in den angegebenen Typ.

public:
 System::Object ^ ConvertTo(System::Object ^ value, Type ^ destinationType);

public object? ConvertTo (object? value, Type destinationType);

member this.ConvertTo : obj * Type -> obj

Public Function ConvertTo (value As Object, destinationType As Type) As Object

Parameter

value

Object

Die zu konvertierende Object.

destinationType

Type

Der Type, in den der value-Parameter konvertiert werden soll.

Gibt zurück

Object

Ein Object, das den konvertierten Wert darstellt.

Ausnahmen

ArgumentNullException

Der destinationType-Parameter ist null.

NotSupportedException

Die Konvertierung kann nicht durchgeführt werden.

Hinweise

Der gängigste Typ, der in und aus konvertiert werden soll, ist ein Zeichenfolgenobjekt. Diese Implementierung ruft ToString das -Objekt auf, wenn das Objekt gültig ist und wenn der Zieltyp eine Zeichenfolge ist.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Quelle:

TypeConverter.cs

Konvertiert das angegebene Wertobjekt in den angegebenen Typ mit dem angegebenen Kontext und Kulturinformationen.

public:
 virtual System::Object ^ ConvertTo(System::ComponentModel::ITypeDescriptorContext ^ context, System::Globalization::CultureInfo ^ culture, System::Object ^ value, Type ^ destinationType);

public virtual object? ConvertTo (System.ComponentModel.ITypeDescriptorContext? context, System.Globalization.CultureInfo? culture, object? value, Type destinationType);

abstract member ConvertTo : System.ComponentModel.ITypeDescriptorContext * System.Globalization.CultureInfo * obj * Type -> obj
override this.ConvertTo : System.ComponentModel.ITypeDescriptorContext * System.Globalization.CultureInfo * obj * Type -> obj

Public Overridable Function ConvertTo (context As ITypeDescriptorContext, culture As CultureInfo, value As Object, destinationType As Type) As Object

Parameter

context

ITypeDescriptorContext

Ein ITypeDescriptorContext, der einen Formatierungskontext bereitstellt.

culture

CultureInfo

Ein CultureInfo. Wenn null übergeben wird, wird von der aktuellen Kultur ausgegangen.

value

Object

Die zu konvertierende Object.

destinationType

Type

Der Type, in den der value-Parameter konvertiert werden soll.

Gibt zurück

Object

Ein Object, das den konvertierten Wert darstellt.

Ausnahmen

ArgumentNullException

Der destinationType-Parameter ist null.

NotSupportedException

Die Konvertierung kann nicht durchgeführt werden.

Hinweise

Am häufigsten wird in Zeichenfolgenobjekte und aus diesen konvertiert. Diese Implementierung ruft ToString das -Objekt auf, wenn das Objekt gültig ist und wenn der Zieltyp eine Zeichenfolge ist.

Über den context-Parameter können zusätzliche Informationen über die Umgebung extrahiert werden, aus der dieser Konverter aufgerufen wurde. Dieser Parameter kann sein null. Überprüfen Sie ihn also immer. Außerdem können die Eigenschaften des Kontextobjekts null zurückgeben.

Benutzerdefinierte Typautoren, die ein Typkonvertierungsverhalten für XAML unterstützen möchten, implementieren in der Regel eine TypeConverter Klasse, die das Verhalten aus einer Zeichenfolge unterstützt ConvertFrom . Diese Typkonverter können auch implementieren ConvertTo , um die Serialisierung zurück in XAML zu unterstützen.

Einige XAML-Serialisierungsszenarien können nicht ausreichend mit TypeConverter allein behandelt werden. In diesen Fällen kann es erforderlich sein, auch eine ValueSerializer zu definieren, die die Serialisierungsfälle behandelt, die andernfalls von ConvertTobehandelt würden. Weitere Informationen finden Sie unter ValueSerializer.

Hinweise für Vererber

Überschreiben Sie diese Methode, um eigene Konvertierungsanforderungen anzugeben.

Implementierungsmuster für Typkonverter, die zur Unterstützung von XAML und benutzerdefinierten Typen verwendet werden, finden Sie unter Übersicht über Typkonverter für XAML.

Weitere Informationen

• ITypeDescriptorContext
• Übersicht über Typkonverter für XAML