TypeConverter.ConvertTo Méthode

Définition

Convertit l'objet de valeur donné en type spécifié.

Surcharges

ConvertTo(Object, Type)

Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Convertit l'objet valeur donné au type spécifié, en utilisant le contexte et les informations de culture spécifiés.

ConvertTo(Object, Type)

Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments.

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

Paramètres

value
Object

Object à convertir.

destinationType
Type

Type auquel le paramètre value doit être converti.

Retours

Object

Object qui représente la valeur convertie.

Exceptions

Le paramètre destinationType a la valeur null.

La conversion ne peut pas être effectuée.

Remarques

Le type le plus courant à convertir vers et à partir est un objet string. Cette implémentation appelle ToString l’objet, si l’objet est valide et si le type de destination est une chaîne.

S’applique à

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Convertit l'objet valeur donné au type spécifié, en utilisant le contexte et les informations de culture spécifiés.

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

Paramètres

context
ITypeDescriptorContext

ITypeDescriptorContext qui fournit un contexte de format.

culture
CultureInfo

CultureInfo Si la valeur null est passée, la culture est supposée être la culture actuelle.

value
Object

Object à convertir.

destinationType
Type

Type auquel le paramètre value doit être converti.

Retours

Object

Object qui représente la valeur convertie.

Exceptions

Le paramètre destinationType a la valeur null.

La conversion ne peut pas être effectuée.

Remarques

Les conversions de type les plus courantes consistent à effectuer une conversion vers un objet chaîne et à partir de celui-ci. Cette implémentation appelle ToString l’objet si l’objet est valide et si le type de destination est une chaîne.

Utilisez le paramètre context pour extraire des informations supplémentaires sur l'environnement à partir duquel ce convertisseur est appelé. Ce paramètre peut être null, donc toujours le vérifier. En outre, les propriétés de l'objet de contexte peuvent retourner null.

Les auteurs de types personnalisés qui ont l’intention de prendre en charge un comportement de conversion de type pour XAML implémentent généralement une classe qui prend en charge ConvertFrom le TypeConverter comportement d’une chaîne. Ces convertisseurs de type peuvent également être implémentés ConvertTo pour prendre en charge la sérialisation en XAML.

Certains scénarios de sérialisation XAML ne peuvent pas être correctement traités seul TypeConverter . 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 ConvertTo. Pour plus d'informations, consultez ValueSerializer.

Notes pour les héritiers

Substituez cette méthode pour fournir vos propres exigences de conversion.

Pour connaître les modèles d’implémentation pour les convertisseurs de types utilisés pour prendre en charge les types XAML et personnalisés, consultez Vue d’ensemble des convertisseurs de types pour XAML.

Voir aussi

S’applique à