TypeConverter 클래스

아티클
08/21/2007

표준 값과 하위 속성에 액세스하기 위한 그리고 값의 형식을 다른 형식으로 변환하기 위한 통합된 방법을 제공합니다.

네임스페이스: System.ComponentModel
어셈블리: System(system.dll)

구문

‘선언
<ComVisibleAttribute(True)> _
Public Class TypeConverter
‘사용 방법
Dim instance As TypeConverter

[ComVisibleAttribute(true)] 
public class TypeConverter

[ComVisibleAttribute(true)] 
public ref class TypeConverter

/** @attribute ComVisibleAttribute(true) */ 
public class TypeConverter

ComVisibleAttribute(true) 
public class TypeConverter

설명

가장 일반적인 변환기 형식은 텍스트 표현으로 변환하거나 텍스트 표현에서 변환하는 형식입니다. 클래스에 대한 형식 변환기는 TypeConverterAttribute를 사용하여 해당 클래스에 바인딩됩니다. 이 특성을 재정의하지 않은 경우 이 클래스에서 상속하는 모든 클래스는 동일한 형식 변환기를 기본 클래스로 사용합니다.

참고

형식 변환기에 직접 액세스하지 말고 대신 TypeDescriptor를 사용하여 적절한 변환기에 액세스합니다. 자세한 내용은 제공되는 코드 예제를 참조하십시오.

상속자 참고 사항 사용자 고유의 변환 요구 사항을 구현하려면 TypeConverter에서 상속합니다. 이 클래스에서 상속하면 다음 메서드를 재정의할 수 있습니다.

사용자 지정 형식 변환을 지원하려면 CanConvertFrom, CanConvertTo, ConvertFrom 및 ConvertTo 메서드를 재정의합니다.
값을 변경하기 위해 개체를 다시 만들어야 하는 형식을 변환하려면 CreateInstance 및 GetCreateInstanceSupported 메서드를 재정의합니다.
속성을 지원하는 형식을 변환하려면 GetProperties 및 GetPropertiesSupported 메서드를 재정의합니다. 변환할 클래스에 속성이 없고 속성을 구현해야 하는 경우 TypeConverter.SimplePropertyDescriptor 클래스를 속성 설명자를 구현하기 위한 기본 클래스로 사용할 수 있습니다. TypeConverter.SimplePropertyDescriptor에서 상속하는 경우 GetValue 및 SetValue 메서드를 재정의해야 합니다.
표준 값을 지원하는 형식을 변환하려면 GetStandardValues, GetStandardValuesExclusive, GetStandardValuesSupported 및 IsValid 메서드를 재정의합니다.

참고

파생 형식을 internal 또는 private으로 표시할 수 있지만 형식의 인스턴스는 TypeDescriptor 클래스를 사용하여 만들 수 없습니다. 호출자를 신뢰할 수 있는 것으로 가정하고 안전하지 않은 코드를 작성하지 마십시오. 대신 호출자가 부분 신뢰 상태에서 형식의 인스턴스를 만들 수 있다고 가정하십시오.

형식 변환기에 대한 자세한 내용은 방법: 형식 변환기 구현 또는 일반화된 형식 변환을 참조하십시오.

참고

이 클래스에 적용되는 HostProtectionAttribute 특성의 Resources 속성 값은 SharedState입니다. HostProtectionAttribute는 대개 아이콘을 두 번 클릭하거나, 명령을 입력하거나, 브라우저에서 URL을 입력하여 시작되는 데스크톱 응용 프로그램에 영향을 미치지 않습니다. 자세한 내용은 HostProtectionAttribute 클래스나 SQL Server 프로그래밍 및 호스트 보호 특성을 참조하십시오.

예제

다음 코드 예제에서는 형식 변환기의 인스턴스를 만들어 클래스에 바인딩하는 방법을 보여 줍니다. MyClassConverter 변환기를 구현하는 클래스는 TypeConverter 클래스에서 상속해야 합니다.

<TypeConverter(GetType(MyClassConverter))> _
Public Class Class1
    ' Insert code here.
End Class 'MyClass

[TypeConverter(typeof(MyClassConverter))]
 public class MyClass {
    // Insert code here.
}

public:
   [TypeConverter(Sample::MyClassConverter::typeid)]
   ref class MyClass
   {
      // Insert code here.
   };

/** @attribute TypeConverter(MyClassConverter.class)
 */
public class MyClass
{
    // Insert code here.
} //MyClass

열거형이 포함된 속성이 있으면 해당 속성을 설정하기 전에 열거형 값이 유효한지 확인합니다. 다음 코드 예제를 실행하려면 MyPropertyEnum이라는 열거형이 선언되어 있어야 합니다.

Public WriteOnly Property MyProperty() As MyPropertyEnum
    Set
        ' Checks to see if the value passed is valid.
        If Not TypeDescriptor.GetConverter(GetType(MyPropertyEnum)).IsValid(value) Then
            Throw New ArgumentException()
        End If
        ' The value is valid. Insert code to set the property.
    End Set 
End Property

public MyPropertyEnum MyProperty {
    set {
       // Checks to see if the value passed is valid.
       if (!TypeDescriptor.GetConverter(typeof(MyPropertyEnum)).IsValid(value)) {
          throw new ArgumentException();
       }
       // The value is valid. Insert code to set the property.
    }
 }

public:
   property MyPropertyEnum MyProperty 
   {
      void set( MyPropertyEnum value )
      {
         // Checks to see if the value passed is valid.
         if ( !TypeDescriptor::GetConverter( MyPropertyEnum::typeid )->IsValid( value ) )
         {
            throw gcnew ArgumentException;
         }
         // The value is valid. Insert code to set the property.
      }
   }

/** @property 
 */
public void set_MyProperty(MyPropertyEnum value)
{
    // Checks to see if the value passed is valid.
    if (!(TypeDescriptor.GetConverter(MyPropertyEnum.class.ToType()).
        IsValid(value))) {
        throw new ArgumentException();
    }
    // The value is valid. Insert code to set the property.
} //set_MyProperty

다른 일반적인 형식 변환기의 용도는 개체를 문자열로 변환하는 것입니다. 다음 코드 예제에서는 c 변수에 저장된 Color의 이름을 출력합니다.

Dim c As Color = Color.Red
Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c))

Color c = Color.Red;
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));

Color c = Color::Red;
Console::WriteLine( TypeDescriptor::GetConverter( c )->ConvertToString( c ) );

Color c = Color.get_Red();
Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));

다음 예제에서처럼 형식 변환기를 사용하여 해당 이름에서 값을 변환할 수도 있습니다.

Dim c As Color = CType(TypeDescriptor.GetConverter(GetType(Color)).ConvertFromString("Red"), Color)

Color c = (Color)TypeDescriptor.GetConverter(typeof(Color)).ConvertFromString("Red");

Color c =  (Color)(TypeDescriptor::GetConverter( Color::typeid )->ConvertFromString( "Red" ));

Color c = (Color)(TypeDescriptor.GetConverter(Color.class.ToType()).
    ConvertFromString("Red"));

다음 코드 예제에서는 형식 변환기를 사용하여 개체가 지원하는 표준 값 집합을 출력하는 방법을 보여 줍니다.

Dim c As Color
For Each c In  TypeDescriptor.GetConverter(GetType(Color)).GetStandardValues()
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c))
Next c

foreach(Color c in TypeDescriptor.GetConverter(typeof(Color)).GetStandardValues()) {
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));
 }

for each ( Color c in TypeDescriptor::GetConverter( Color::typeid )->GetStandardValues() )
{
   Console::WriteLine( TypeDescriptor::GetConverter( c )->ConvertToString( c ) );
}

IEnumerator e = TypeDescriptor.GetConverter(Color.class.ToType()).
    GetStandardValues().GetEnumerator();
while (e.MoveNext()) {
    Color c = (Color)e.get_Current();
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));
}

상속 계층 구조

System.Object
System.ComponentModel.TypeConverter
파생 클래스

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

TypeConverter 멤버
System.ComponentModel 네임스페이스
TypeConverterAttribute
PropertyDescriptorCollection 클래스
TypeConverter.SimplePropertyDescriptor
TypeConverter.StandardValuesCollection

다음을 통해 공유