TypeConverter.ConvertTo Metoda

Definicja

Konwertuje dany obiekt wartości na określony typ.Converts the given value object to the specified type.

Przeciążenia

ConvertTo(Object, Type)

Konwertuje dany obiekt wartości na określony typ, używając argumentów.Converts the given value object to the specified type, using the arguments.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Konwertuje dany obiekt wartości na określony typ, przy użyciu określonych informacji o kontekście i kulturze.Converts the given value object to the specified type, using the specified context and culture information.

ConvertTo(Object, Type)

Konwertuje dany obiekt wartości na określony typ, używając argumentów.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

Parametry

value
Object

Object do przekonwertowania.The Object to convert.

destinationType
Type

Type do przekonwertowania parametru value na.The Type to convert the value parameter to.

Zwraca

Object

Object, która reprezentuje przekonwertowaną wartość.An Object that represents the converted value.

Wyjątki

Parametr destinationType ma wartość null.The destinationType parameter is null.

Nie można wykonać konwersji.The conversion cannot be performed.

Uwagi

Najbardziej typowym typem konwersji do i z jest obiekt ciągu.The most common type to convert to and from is a string object. Ta implementacja wywołuje ToString w obiekcie, jeśli obiekt jest prawidłowy i jeśli typ docelowy jest ciągiem.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)

Konwertuje dany obiekt wartości na określony typ, przy użyciu określonych informacji o kontekście i kulturze.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

Parametry

context
ITypeDescriptorContext

ITypeDescriptorContext, który zawiera kontekst formatu.An ITypeDescriptorContext that provides a format context.

culture
CultureInfo

Klasa CultureInfo.A CultureInfo. Jeśli null jest przenoszona, założono bieżącą kulturę.If null is passed, the current culture is assumed.

value
Object

Object do przekonwertowania.The Object to convert.

destinationType
Type

Type do przekonwertowania parametru value na.The Type to convert the value parameter to.

Zwraca

Object

Object, która reprezentuje przekonwertowaną wartość.An Object that represents the converted value.

Wyjątki

Parametr destinationType ma wartość null.The destinationType parameter is null.

Nie można wykonać konwersji.The conversion cannot be performed.

Uwagi

Najczęściej używane typy do przekonwertowania to i z obiektu String.The most common types to convert are to and from a string object. Ta implementacja wywołuje ToString w obiekcie, jeśli obiekt jest prawidłowy, a typ docelowy to ciąg.This implementation calls ToString on the object if the object is valid and if the destination type is a string.

Użyj parametru context, aby wyodrębnić dodatkowe informacje o środowisku, z którego ten konwerter jest wywoływany.Use the context parameter to extract additional information about the environment from which this converter is invoked. Ten parametr może być null, dlatego należy go zawsze sprawdzić.This parameter can be null, so always check it. Ponadto właściwości obiektu kontekstu mogą zwracać null.Also, properties on the context object can return null.

Autorzy typów niestandardowych, którzy zamierzają obsługiwać zachowanie konwersji typu dla języka XAML zazwyczaj implementują klasę TypeConverter, która obsługuje ConvertFrom zachowanie z ciągu.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. Te konwertery typów mogą również zaimplementować ConvertTo do obsługi serializacji z powrotem do języka XAML.These type converters might also implement ConvertTo to support serialization back to XAML.

Niektóre scenariusze serializacji XAML nie mogą być odpowiednio rozkierowane wyłącznie do TypeConverter.Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. W takich przypadkach może być konieczne zdefiniowanie ValueSerializer, który obsługuje przypadki serializacji, które w przeciwnym razie byłyby obsługiwane przez ConvertTo.In these cases, it may be necessary to also define a ValueSerializer that handles the serialization cases that would otherwise be handled by ConvertTo. Aby uzyskać więcej informacji, zobacz ValueSerializer.For more information, see ValueSerializer.

Uwagi dotyczące dziedziczenia

Zastąp tę metodę, aby zapewnić własne wymagania dotyczące konwersji.Override this method to provide your own conversion requirements.

Dla wzorców implementacji dla konwerterów typów, które są używane do obsługi języka XAML i typów niestandardowych, zobacz konwertery typów dla języka XAML — Omówienie.For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

Zobacz też

Dotyczy