TypeConverter.ConvertTo Méthode

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

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)

Source:

TypeConverter.cs

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);

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

ArgumentNullException

Le paramètre destinationType a la valeur null.

NotSupportedException

La conversion ne peut pas être effectuée.

Remarques

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

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Source:

TypeConverter.cs

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);

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

ArgumentNullException

Le paramètre destinationType a la valeur null.

NotSupportedException

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 sur 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 case activée-le. 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 TypeConverter classe qui prend en charge ConvertFrom le comportement d’une chaîne. Ces convertisseurs de type peuvent également implémenter pour prendre en ConvertTo charge la sérialisation en XAML.

Certains scénarios de sérialisation XAML ne peuvent pas être traités correctement avec TypeConverter seul. Dans ce 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

• ITypeDescriptorContext
• Vue d’ensemble des convertisseurs de types pour XAML