TypeConverter.ConvertTo Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Konwertuje dany obiekt wartości na określony typ.

Przeciążenia

ConvertTo(Object, Type)	Konwertuje podany obiekt wartości na określony typ przy użyciu argumentów.
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Konwertuje dany obiekt wartości na określony typ przy użyciu określonych kontekstów i informacji o kulturze.

ConvertTo(Object, Type)

Źródło:

TypeConverter.cs

Konwertuje podany obiekt wartości na określony typ przy użyciu argumentów.

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

Element Object do konwersji.

destinationType

Type

Element Type , aby przekonwertować value parametr na.

Zwraca

Object

Element Object reprezentujący przekonwertowaną wartość.

Wyjątki

ArgumentNullException

Parametr destinationType to null.

NotSupportedException

Nie można wykonać konwersji.

Uwagi

Najczęściej używanym typem do konwersji na i z jest obiekt ciągu. Ta implementacja wywołuje ToString obiekt, jeśli obiekt jest prawidłowy i czy typ docelowy jest ciągiem.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Źródło:

TypeConverter.cs

Konwertuje dany obiekt wartości na określony typ przy użyciu określonych kontekstów i informacji o kulturze.

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

Element ITypeDescriptorContext , który udostępnia kontekst formatu.

culture

CultureInfo

Klasa CultureInfo. Jeśli null zostanie przekazana, przyjmuje się bieżącą kulturę.

value

Object

Element Object do konwersji.

destinationType

Type

Element Type , aby przekonwertować value parametr na.

Zwraca

Object

Element Object reprezentujący przekonwertowaną wartość.

Wyjątki

ArgumentNullException

Parametr destinationType to null.

NotSupportedException

Nie można wykonać konwersji.

Uwagi

Najpopularniejsze typy do konwersji to i z obiektu ciągu. Ta implementacja wywołuje ToString obiekt, jeśli obiekt jest prawidłowy, a jeśli typ docelowy jest ciągiem.

Użyj parametru , context aby wyodrębnić dodatkowe informacje o środowisku, z którego jest wywoływany ten konwerter. Ten parametr może mieć wartość null, więc zawsze go sprawdzaj. Ponadto właściwości obiektu kontekstu mogą zwracać wartość null.

Autorzy typów niestandardowych, którzy zamierzają obsługiwać zachowanie konwersji typów dla języka XAML, zwykle implementują klasę TypeConverter , która obsługuje ConvertFrom zachowanie z ciągu. Te konwertery typów mogą również implementować obsługę ConvertTo serializacji z powrotem do XAML.

Niektórych scenariuszy serializacji XAML nie można odpowiednio rozwiązać z TypeConverter samymi sobie. W takich przypadkach może być konieczne również zdefiniowanie klasy obsługującej przypadki serializacji, które w przeciwnym razie będą obsługiwane przez usługę ValueSerializerConvertTo. Aby uzyskać więcej informacji, zobacz ValueSerializer.

Uwagi dotyczące dziedziczenia

Zastąpij tę metodę, aby zapewnić własne wymagania dotyczące konwersji.

Aby uzyskać wzorce implementacji konwerterów typów używanych do obsługi języka XAML i typów niestandardowych, zobacz Konwertery typów dla języka XAML — omówienie.

Zobacz też

• ITypeDescriptorContext
• Omówienie konwerterów typów dla języka XAML