TypeConverter.ConvertTo 메서드

정의

주어진 값 개체를 지정한 형식으로 변환합니다.Converts the given value object to the specified type.

오버로드

ConvertTo(Object, Type)

인수를 사용하여, 지정된 값 개체를 지정된 형식으로 변환합니다.Converts the given value object to the specified type, using the arguments.

ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

지정한 컨텍스트와 culture 정보를 사용하여 지정된 값 개체를 지정된 유형으로 변환합니다.Converts the given value object to the specified type, using the specified context and culture information.

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입니다.The Object to convert.

destinationType
Type

value 매개 변수를 변환할 Type입니다.The Type to convert the value parameter to.

반환

Object

변환된 값을 나타내는 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)

지정한 컨텍스트와 culture 정보를 사용하여 지정된 값 개체를 지정된 유형으로 변환합니다.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입니다.An ITypeDescriptorContext that provides a format context.

culture
CultureInfo

CultureInfoA CultureInfo. null이 전달되면 현재 문화권이 가정됩니다.If null is passed, the current culture is assumed.

value
Object

변환할 Object입니다.The Object to convert.

destinationType
Type

value 매개 변수를 변환할 Type입니다.The Type to convert the value parameter to.

반환

Object

변환된 값을 나타내는 Object입니다.An Object that represents the converted value.

예외

destinationType 매개 변수가 null인 경우The destinationType parameter is null.

변환할 수 없는 경우The conversion cannot be performed.

설명

string 개체 간의 형식 변환이 가장 일반적입니다.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로 serialization을 다시 지원할 수도 있습니다.These type converters might also implement ConvertTo to support serialization back to XAML.

일부 XAML serialization 시나리오는 단독으로 적절 하 게 처리할 수 없습니다 TypeConverter .Some XAML serialization scenarios cannot be adequately addressed with TypeConverter alone. 이 경우에서 ValueSerializer 다른 방식으로 처리 되지 않는 serialization 사례를 처리 하는도 정의 해야 할 수 있습니다 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.

추가 정보

적용 대상