TypeConverter.ConvertTo Метод

Определение

Пространство имен:

System.ComponentModel

Сборки:

netstandard.dll, System.ComponentModel.TypeConverter.dll

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

Перегрузки

Имя	Описание
ConvertTo(Object, Type)	Преобразует заданный объект значения в указанный тип с помощью аргументов.
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Преобразует заданный объект значения в указанный тип, используя указанный контекст и сведения о языке и региональных параметрах.

ConvertTo(Object, Type)

Исходный код:

TypeConverter.cs

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

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 объект.

destinationType

Type

Значение Type для преобразования value параметра в.

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

Object

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

Исключения

ArgumentNullException

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

NotSupportedException

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

Комментарии

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

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Исходный код:

TypeConverter.cs

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

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 предоставляющий контекст формата.

culture

CultureInfo

А CultureInfo. Если null он передается, предполагается текущий язык и региональные параметры.

value

Object

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

destinationType

Type

Значение Type для преобразования value параметра в.

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

Object

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

Исключения

ArgumentNullException

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

NotSupportedException

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

Комментарии

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

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

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

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

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

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

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

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

• ITypeDescriptorContext
• Обзор преобразователей типов для XAML