TypeConverter.ConvertTo Метод

Определение

Преобразует данный объект в указанный тип.

Перегрузки

ConvertTo(Object, Type)

Преобразует данное значение в указанный тип, используя заданные аргументы.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Преобразует заданный объект значения в указанный тип с использованием указанного контекста и сведений о культуре.

ConvertTo(Object, Type)

Преобразует данное значение в указанный тип, используя заданные аргументы.

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

Параметры

value
Object

Преобразуемый объект Object.

destinationType
Type

Type, к которому преобразуется параметр value.

Возвращаемое значение

Object

Object, представляющий преобразованное значение.

Исключения

Параметр destinationType имеет значение null.

Преобразование не может быть выполнено.

Комментарии

Наиболее распространенный тип для преобразования в и из — это строковый объект. Эта реализация вызывает ToString объект, если объект является допустимым, а целевой тип — строкой.

Применяется к

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Преобразует заданный объект значения в указанный тип с использованием указанного контекста и сведений о культуре.

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

Параметры

context
ITypeDescriptorContext

Объект ITypeDescriptorContext, предоставляющий контекст формата.

culture
CultureInfo

Объект CultureInfo. Если передано значение null, используются текущие настройки языка и региональных параметров.

value
Object

Преобразуемый объект Object.

destinationType
Type

Type, к которому преобразуется параметр value.

Возвращаемое значение

Object

Object, представляющий преобразованное значение.

Исключения

Параметр destinationType имеет значение null.

Преобразование не может быть выполнено.

Комментарии

Чаще всего в преобразовании участвуют строковые объекты. Эта реализация вызывает ToString объект, если объект является допустимым, а целевой тип — строкой.

Для получения дополнительных сведений о среде, из которой вызывается этот преобразователь, используйте параметр context. Этот параметр может быть null , поэтому всегда следует его проверять. Свойства объекта контекста могут также возвращать значение null.

Авторы пользовательских типов, которые должны поддерживать поведение преобразования типов для XAML, обычно реализуют TypeConverter класс, который поддерживает ConvertFrom поведение из строки. Эти преобразователи типов также могут реализовать ConvertTo для поддержки сериализации обратно в XAML.

Некоторые сценарии сериализации XAML не могут быть адекватно устранены с помощью TypeConverter одного. В таких случаях может потребоваться определить объект ValueSerializer , обрабатывающий варианты сериализации, которые в противном случае будут обрабатываться ConvertTo . Для получения дополнительной информации см. ValueSerializer.

Примечания для тех, кто наследует этот метод

Переопределите этот метод в соответствии с требованиями к преобразованию.

Шаблоны реализации для преобразователей типов, которые используются для поддержки XAML и пользовательских типов, см. в разделе Общие сведения о преобразователях типов для XAML.

См. также раздел

Применяется к