TypeConverter.ConvertTo Methode

Definition

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
Quelle:
TypeConverter.cs
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);
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

Ein Object, das den konvertierten Wert darstellt.

Ausnahmen

Der destinationType-Parameter ist null.

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.

Gilt für:

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Quelle:
TypeConverter.cs
Quelle:
TypeConverter.cs
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);
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

Ein Object, das den konvertierten Wert darstellt.

Ausnahmen

Der destinationType-Parameter ist null.

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

Gilt für: