TypeConverter.ConvertTo TypeConverter.ConvertTo TypeConverter.ConvertTo TypeConverter.ConvertTo Method

Definition

Konvertiert das angegebene Wertobjekt in den angegebenen Typ.Converts the given value object to the specified type.

Überlädt

ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type)

Konvertiert das angegebene Wertobjekt unter Verwendung der Argumente in den angegebenen Typ.Converts the given value object to the specified type, using the arguments.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Konvertiert das angegebene Wertobjekt unter Verwendung des angegebenen Kontexts und der angegebenen Kulturinformationen in den angegebenen Typ.Converts the given value object to the specified type, using the specified context and culture information.

ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type) ConvertTo(Object, Type)

Konvertiert das angegebene Wertobjekt unter Verwendung der Argumente in den angegebenen Typ.Converts the given value object to the specified type, using the arguments.

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

Die zu konvertierende Object.The Object to convert.

destinationType
Type Type Type Type

Der Type, in den der value-Parameter konvertiert werden soll.The Type to convert the value parameter to.

Gibt zurück

Ein Object, das den konvertierten Wert darstellt.An Object that represents the converted value.

Ausnahmen

Der destinationType-Parameter ist null.The destinationType parameter is null.

Die Konvertierung kann nicht durchgeführt werden.The conversion cannot be performed.

Hinweise

Der häufigste Typ, der in und aus konvertiert werden soll, ist ein String-Objekt.The most common type to convert to and from is a string object. Diese Implementierung ruft ToString für das-Objekt auf, wenn das-Objekt gültig ist und der Zieltyp eine Zeichenfolge ist.This implementation calls ToString on the object, if the object is valid and if the destination type is a string.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Konvertiert das angegebene Wertobjekt unter Verwendung des angegebenen Kontexts und der angegebenen Kulturinformationen in den angegebenen Typ.Converts the given value object to the specified type, using the specified context and culture information.

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

Ein ITypeDescriptorContext, der einen Formatierungskontext bereitstellt.An ITypeDescriptorContext that provides a format context.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

Ein CultureInfo.A CultureInfo. Wenn null übergeben wird, wird von der aktuellen Kultur ausgegangen.If null is passed, the current culture is assumed.

value
Object Object Object Object

Die zu konvertierende Object.The Object to convert.

destinationType
Type Type Type Type

Der Type, in den der value-Parameter konvertiert werden soll.The Type to convert the value parameter to.

Gibt zurück

Ein Object, das den konvertierten Wert darstellt.An Object that represents the converted value.

Ausnahmen

Der destinationType-Parameter ist null.The destinationType parameter is null.

Die Konvertierung kann nicht durchgeführt werden.The conversion cannot be performed.

Hinweise

Am häufigsten wird in Zeichenfolgenobjekte und aus diesen konvertiert.The most common types to convert are to and from a string object. Diese Implementierung ruft ToString für das-Objekt auf, wenn das-Objekt gültig ist, und, wenn der Zieltyp eine Zeichenfolge ist.This implementation calls ToString on the object if the object is valid and if the destination type is a string.

Über den context-Parameter können zusätzliche Informationen über die Umgebung extrahiert werden, aus der dieser Konverter aufgerufen wurde.Use the context parameter to extract additional information about the environment from which this converter is invoked. Dieser Parameter kann sein null, daher sollten Sie ihn immer überprüfen.This parameter can be null, so always check it. Außerdem können die Eigenschaften des Kontextobjekts null zurückgeben.Also, properties on the context object can return null.

Benutzerdefinierte typautoren, die ein Typkonvertierungs Verhalten für XAML unterstützen möchten TypeConverter , implementieren Normal ConvertFrom erweise eine Klasse, die das Verhalten von einer Zeichenfolge unterstützt.Custom type authors that intend to support a type conversion behavior for XAML typically implement a TypeConverter class that supports ConvertFrom behavior from a string. Diese Typkonverter können auch implementieren ConvertTo , um die Serialisierung zurück in XAML zu unterstützen.These type converters might also implement ConvertTo to support serialization back to XAML.

Einige XAML-Serialisierungsszenarien können TypeConverter nicht mit alleine adressiert werden.Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. In diesen Fällen kann es auch erforderlich sein, eine ValueSerializer zu definieren, die die serialisierungsfälle behandelt, die andernfalls von ConvertTobehandelt werden.In these cases, it may be necessary to also define a ValueSerializer that handles the serialization cases that would otherwise be handled by ConvertTo. Weitere Informationen finden Sie unter ValueSerializer.For more information, see ValueSerializer.

Hinweise für Vererber

Überschreiben Sie diese Methode, um eigene Konvertierungsanforderungen anzugeben.Override this method to provide your own conversion requirements.

Implementierungs Muster für Typkonverter, die zur Unterstützung von XAML-und benutzerdefinierten Typen verwendet werden, finden Sie unter Übersicht über Typkonverter für XAML.For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

Siehe auch

Gilt für: