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

Definizione

Converte l'oggetto valore specificato nel tipo specificato.Converts the given value object to the specified type.

Overload

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

Converte l'oggetto valore specificato nel tipo specificato, utilizzando gli argomenti.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)

Converte l'oggetto valore indicato nel tipo specificato, usando il contesto e le informazioni sulle impostazioni cultura specificati.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)

Converte l'oggetto valore specificato nel tipo specificato, utilizzando gli argomenti.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

Parametri

value
Object Object Object Object

Oggetto Object da convertire.The Object to convert.

destinationType
Type Type Type Type

Type in cui convertire il parametro value.The Type to convert the value parameter to.

Restituisce

Oggetto Object che rappresenta il valore convertito.An Object that represents the converted value.

Eccezioni

Il valore del parametro destinationType è null.The destinationType parameter is null.

Impossibile eseguire la conversione.The conversion cannot be performed.

Commenti

Il tipo più comune da convertire in e da è un oggetto stringa.The most common type to convert to and from is a string object. Questa implementazione chiama ToString sull'oggetto, se l'oggetto è valido e se il tipo di destinazione è una stringa.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)

Converte l'oggetto valore indicato nel tipo specificato, usando il contesto e le informazioni sulle impostazioni cultura specificati.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

Parametri

context
ITypeDescriptorContext ITypeDescriptorContext ITypeDescriptorContext ITypeDescriptorContext

Oggetto ITypeDescriptorContext che fornisce un contesto di formato.An ITypeDescriptorContext that provides a format context.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

Oggetto CultureInfo.A CultureInfo. Se viene passato null , verranno usate le impostazioni cultura correnti.If null is passed, the current culture is assumed.

value
Object Object Object Object

Oggetto Object da convertire.The Object to convert.

destinationType
Type Type Type Type

Type in cui convertire il parametro value.The Type to convert the value parameter to.

Restituisce

Oggetto Object che rappresenta il valore convertito.An Object that represents the converted value.

Eccezioni

Il valore del parametro destinationType è null.The destinationType parameter is null.

Impossibile eseguire la conversione.The conversion cannot be performed.

Commenti

I tipi più comuni di conversione sono da e verso un oggetto stringa.The most common types to convert are to and from a string object. Questa implementazione chiama ToString sull'oggetto se l'oggetto è valido e se il tipo di destinazione è una stringa.This implementation calls ToString on the object if the object is valid and if the destination type is a string.

Utilizzare il parametro context per estrarre ulteriori informazioni sull'ambiente dal quale viene richiamato il convertitore.Use the context parameter to extract additional information about the environment from which this converter is invoked. Questo parametro può essere null, quindi controllarlo sempre.This parameter can be null, so always check it. Anche le proprietà dell'oggetto di contesto possono restituire null.Also, properties on the context object can return null.

Gli autori di tipi personalizzati che intendono supportare un comportamento di conversione dei tipi per TypeConverter XAML in genere ConvertFrom implementano una classe che supporta il comportamento da una stringa.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. Questi convertitori di tipi possono implementare ConvertTo anche per supportare la serializzazione in XAML.These type converters might also implement ConvertTo to support serialization back to XAML.

Alcuni scenari di TypeConverter serializzazione XAML non possono essere risolti adeguatamente da soli.Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. In questi casi, potrebbe essere necessario definire anche un oggetto ValueSerializer che gestisce i case di serializzazione che altrimenti verrebbero gestiti da. ConvertToIn these cases, it may be necessary to also define a ValueSerializer that handles the serialization cases that would otherwise be handled by ConvertTo. Per ulteriori informazioni, vedere ValueSerializer.For more information, see ValueSerializer.

Note per gli eredi

Eseguire l'override del metodo per fornire specifici requisiti di conversione.Override this method to provide your own conversion requirements.

Per i modelli di implementazione per i convertitori di tipi usati per supportare i tipi XAML e personalizzati, vedere la panoramica dei convertitori di tipi per XAML.For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

Vedi anche

Si applica a