TypeConverter.ConvertTo 메서드

정의

주어진 값 개체를 지정한 형식으로 변환합니다.

오버로드

ConvertTo(Object, Type)

인수를 사용하여, 지정된 값 개체를 지정된 형식으로 변환합니다.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

지정한 컨텍스트와 culture 정보를 사용하여 지정된 값 개체를 지정된 유형으로 변환합니다.

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

value 매개 변수를 변환할 Type입니다.

반환

Object

변환된 값을 나타내는 Object입니다.

예외

destinationType 매개 변수가 null인 경우

변환할 수 없는 경우

설명

변환할 가장 일반적인 형식은 문자열 개체입니다. 이 구현은 개체가 유효한 경우 및 대상 형식이 문자열인 경우 개체를 호출 ToString 합니다.

적용 대상

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

지정한 컨텍스트와 culture 정보를 사용하여 지정된 값 개체를 지정된 유형으로 변환합니다.

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

value 매개 변수를 변환할 Type입니다.

반환

Object

변환된 값을 나타내는 Object입니다.

예외

destinationType 매개 변수가 null인 경우

변환할 수 없는 경우

설명

string 개체 간의 형식 변환이 가장 일반적입니다. 이 구현은 개체가 유효하고 대상 형식이 문자열인 경우 개체를 호출 ToString 합니다.

이 변환기가 호출되는 환경에 대한 추가 정보를 추출하려면 context 매개 변수를 사용합니다. 이 매개 변수 수 null항상 확인 합니다. 또한 컨텍스트 개체의 속성은 null을 반환할 수도 있습니다.

XAML에 대한 형식 변환 동작을 지원하려는 사용자 지정 형식 작성자는 일반적으로 문자열의 동작을 TypeConverter 지원하는 클래스를 구현합니다 ConvertFrom . 이러한 형식 변환기는 XAML로의 serialization을 지원하도록 구현 ConvertTo 할 수도 있습니다.

일부 XAML serialization 시나리오는 단독으로 적절하게 해결할 TypeConverter 수 없습니다. 이러한 경우 그렇지 않으면 처리될 serialization 사례를 처리하는 을 정의 ValueSerializer 해야 할 수도 ConvertTo있습니다. 자세한 내용은 ValueSerializer를 참조하세요.

상속자 참고

사용자의 변환 요구 사항을 제공하려면 이 메서드를 재정의합니다.

XAML 및 사용자 지정 형식을 지원하는 데 사용되는 형식 변환기 구현 패턴은 XAML용 형식 변환기 개요를 참조하세요.

추가 정보

적용 대상