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

Определение

Преобразует заданный объект значения к указанному типу.Converts the given value object to the specified type.

Перегрузки

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

Преобразует данное значение в указанный тип, используя заданные аргументы.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)

Преобразует данное значение в указанный тип, используя заданные сведения о контексте, а также о языке и региональных параметрах.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)

Преобразует данное значение в указанный тип, используя заданные аргументы.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

Параметры

value
Object Object Object Object

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

destinationType
Type Type Type Type

Type, к которому преобразуется параметр value.The Type to convert the value parameter to.

Возвраты

Object, представляющий преобразованное значение.An Object that represents the converted value.

Исключения

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

Преобразование не может быть выполнено.The conversion cannot be performed.

Комментарии

Наиболее распространенный тип для преобразования в и из — это строковый объект.The most common type to convert to and from is a string object. Эта реализация вызывает ToString объект, если объект является допустимым, а целевой тип — строкой.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)

Преобразует данное значение в указанный тип, используя заданные сведения о контексте, а также о языке и региональных параметрах.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

Параметры

context
ITypeDescriptorContext ITypeDescriptorContext ITypeDescriptorContext ITypeDescriptorContext

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

culture
CultureInfo CultureInfo CultureInfo CultureInfo

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

value
Object Object Object Object

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

destinationType
Type Type Type Type

Type, к которому преобразуется параметр value.The Type to convert the value parameter to.

Возвраты

Object, представляющий преобразованное значение.An Object that represents the converted value.

Исключения

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

Преобразование не может быть выполнено.The conversion cannot be performed.

Комментарии

Чаще всего в преобразовании участвуют строковые объекты.The most common types to convert are to and from a string object. Эта реализация вызывает ToString объект, если объект является допустимым, а целевой тип — строкой.This implementation calls ToString on the object if the object is valid and if the destination type is a string.

Для получения дополнительных сведений о среде, из которой вызывается этот преобразователь, используйте параметр context.Use the context parameter to extract additional information about the environment from which this converter is invoked. Этот параметр может быть null, поэтому всегда следует его проверять.This parameter can be null, so always check it. Свойства объекта контекста могут также возвращать значение null.Also, properties on the context object can return null.

Авторы пользовательских типов, которые должны поддерживать поведение преобразования типов для XAML, обычно реализуют TypeConverter класс, который ConvertFrom поддерживает поведение из строки.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. Эти преобразователи типов также могут реализовать ConvertTo для поддержки сериализации обратно в XAML.These type converters might also implement ConvertTo to support serialization back to XAML.

Некоторые сценарии сериализации XAML не могут быть адекватно устранены TypeConverter с помощью одного.Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. В таких случаях может потребоваться определить объект ValueSerializer , обрабатывающий варианты сериализации, которые в противном случае будут 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. Для получения дополнительной информации см. ValueSerializer.For more information, see ValueSerializer.

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

Переопределите этот метод в соответствии с требованиями к преобразованию.Override this method to provide your own conversion requirements.

Шаблоны реализации для преобразователей типов, которые используются для поддержки XAML и пользовательских типов, см. в разделе Общие сведения о преобразователях типов для XAML.For implementation patterns for type converters that are used to support XAML and custom types, see Type Converters for XAML Overview.

Дополнительно

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