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

Définition

Convertit l'objet de valeur donné en objet du type spécifié.Converts the given value object to the specified type.

Surcharges

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

Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments.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)

Convertit l’objet de valeur donné en objet du type spécifié, en utilisant le contexte et les informations de culture spécifiés.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)

Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments.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

Paramètres

value
Object Object Object Object

Object à convertir.The Object to convert.

destinationType
Type Type Type Type

Type auquel le paramètre value doit être converti.The Type to convert the value parameter to.

Retours

Object qui représente la valeur convertie.An Object that represents the converted value.

Exceptions

Le paramètre destinationType a la valeur null.The destinationType parameter is null.

La conversion ne peut pas être effectuée.The conversion cannot be performed.

Remarques

Le type le plus courant à convertir en et à partir de est un objet String.The most common type to convert to and from is a string object. Cette implémentation appelle ToString sur l’objet, si l’objet est valide et si le type de destination est une chaîne.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)

Convertit l’objet de valeur donné en objet du type spécifié, en utilisant le contexte et les informations de culture spécifiés.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

Paramètres

culture
CultureInfo CultureInfo CultureInfo CultureInfo

CultureInfoA CultureInfo. Si la valeur null est passée, la culture est supposée être la culture actuelle.If null is passed, the current culture is assumed.

value
Object Object Object Object

Object à convertir.The Object to convert.

destinationType
Type Type Type Type

Type auquel le paramètre value doit être converti.The Type to convert the value parameter to.

Retours

Object qui représente la valeur convertie.An Object that represents the converted value.

Exceptions

Le paramètre destinationType a la valeur null.The destinationType parameter is null.

La conversion ne peut pas être effectuée.The conversion cannot be performed.

Remarques

Les conversions de type les plus courantes consistent à effectuer une conversion vers un objet chaîne et à partir de celui-ci.The most common types to convert are to and from a string object. Cette implémentation appelle ToString sur l’objet si l’objet est valide et si le type de destination est une chaîne.This implementation calls ToString on the object if the object is valid and if the destination type is a string.

Utilisez le paramètre context pour extraire des informations supplémentaires sur l'environnement à partir duquel ce convertisseur est appelé.Use the context parameter to extract additional information about the environment from which this converter is invoked. Ce paramètre peut être null, donc toujours le vérifier.This parameter can be null, so always check it. En outre, les propriétés de l'objet de contexte peuvent retourner null.Also, properties on the context object can return null.

Les créateurs de types personnalisés qui envisagent de prendre en charge un comportement de TypeConverter conversion de type ConvertFrom pour XAML implémentent généralement une classe qui prend en charge le comportement d’une chaîne.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. Ces convertisseurs de type peuvent également ConvertTo implémenter pour prendre en charge la sérialisation en XAML.These type converters might also implement ConvertTo to support serialization back to XAML.

Certains scénarios de sérialisation XAML ne peuvent pas être résolus de manière appropriée avec TypeConverter seul.Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. Dans ces cas, il peut être nécessaire de définir également un ValueSerializer qui gère les cas de sérialisation qui seraient autrement gérés par. ConvertToIn these cases, it may be necessary to also define a ValueSerializer that handles the serialization cases that would otherwise be handled by ConvertTo. Pour plus d'informations, consultez ValueSerializer.For more information, see ValueSerializer.

Notes pour les héritiers

Substituez cette méthode pour fournir vos propres exigences de conversion.Override this method to provide your own conversion requirements.

Pour obtenir des modèles d’implémentation pour les convertisseurs de type utilisés pour prendre en charge XAML et les types personnalisés, consultez vue d’ensemble des convertisseurs de type pour XAML.For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

Voir aussi

S’applique à