TypeConverter.ConvertTo Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- TypeConverter.cs
- 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);
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
Retours
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 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.
S’applique à
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)
- Source:
- TypeConverter.cs
- Source:
- TypeConverter.cs
- 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);
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.
Retours
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 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.