TypeConverter.ConvertTo Metodo

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Converte l'oggetto valore specificato nel tipo specificato.

Overload

ConvertTo(Object, Type)	Converte l'oggetto valore specificato nel tipo specificato, utilizzando gli argomenti.
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte l'oggetto valore specificato nel tipo del convertitore mediante il contesto e le informazioni sulle impostazioni cultura specificati.

ConvertTo(Object, Type)

Converte l'oggetto valore specificato nel tipo specificato, utilizzando gli argomenti.

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

Parametri

value

Object

Oggetto Object da convertire.

destinationType

Type

Type in cui convertire il parametro value.

Restituisce

Object

Oggetto Object che rappresenta il valore convertito.

Eccezioni

ArgumentNullException

Il valore del parametro destinationType è null.

NotSupportedException

Impossibile eseguire la conversione.

Commenti

Il tipo più comune da convertire in e da è un oggetto stringa. Questa implementazione chiama ToString l'oggetto, se l'oggetto è valido e se il tipo di destinazione è una stringa.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Converte l'oggetto valore specificato nel tipo del convertitore mediante il contesto e le informazioni sulle impostazioni cultura specificati.

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

Parametri

context

ITypeDescriptorContext

Oggetto ITypeDescriptorContext che fornisce un contesto di formato.

culture

CultureInfo

Oggetto CultureInfo. Se viene passato null, verranno usate le impostazioni cultura correnti.

value

Object

Oggetto Object da convertire.

destinationType

Type

Type in cui convertire il parametro value.

Restituisce

Object

Oggetto Object che rappresenta il valore convertito.

Eccezioni

ArgumentNullException

Il valore del parametro destinationType è null.

NotSupportedException

Impossibile eseguire la conversione.

Commenti

I tipi più comuni di conversione sono da e verso un oggetto stringa. Questa implementazione chiama ToString l'oggetto se l'oggetto è valido e se il tipo di destinazione è una stringa.

Utilizzare il parametro context per estrarre ulteriori informazioni sull'ambiente dal quale viene richiamato il convertitore. Questo parametro può essere null, quindi controllarlo sempre. Anche le proprietà dell'oggetto di contesto possono restituire null.

Gli autori di tipi personalizzati che intendono supportare un comportamento di conversione dei tipi per XAML implementano in genere una classe che supporta ConvertFrom il TypeConverter comportamento da una stringa. Questi convertitori di tipi possono anche implementare ConvertTo per supportare la serializzazione in XAML.

Alcuni scenari di serializzazione XAML non possono essere risolti adeguatamente da TypeConverter soli. In questi casi, potrebbe essere necessario definire anche un ValueSerializer oggetto che gestisce i casi di serializzazione che altrimenti verranno gestiti da ConvertTo. Per altre informazioni, vedere ValueSerializer.

Note per gli eredi

Eseguire l'override del metodo per fornire specifici requisiti di conversione.

Per i modelli di implementazione per i convertitori di tipi usati per supportare tipi XAML e personalizzati, vedere Convertitori di tipi per la panoramica XAML.

Vedi anche

• ITypeDescriptorContext
• Panoramica dei convertitori di tipi per XAML