내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

TypeConverter 클래스

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

System.Object
  System.ComponentModel.TypeConverter
    자세히...

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

[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class TypeConverter

TypeConverter 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드XNA Framework에서 지원TypeConverter TypeConverter 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 메서드CanConvertFrom(Type)이 변환기가 지정된 형식의 개체를 이 변환기의 형식으로 변환할 수 있는지 여부를 반환합니다.
Public 메서드CanConvertFrom(ITypeDescriptorContext, Type)이 변환기가 지정된 컨텍스트를 사용하여 지정된 형식의 개체를 이 변환기의 기본 형식으로 변환할 수 있는지 여부를 반환합니다.
Public 메서드CanConvertTo(Type)이 변환기가 개체를 지정된 형식으로 변환할 수 있는지 여부를 반환합니다.
Public 메서드CanConvertTo(ITypeDescriptorContext, Type)이 변환기가 지정된 컨텍스트를 사용하여 개체를 지정된 형식으로 변환할 수 있는지 여부를 반환합니다.
Public 메서드ConvertFrom(Object)지정된 값을 이 변환기의 형식으로 변환합니다.
Public 메서드ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)지정된 컨텍스트 및 culture 정보를 사용하여, 지정된 개체를 이 변환기의 형식으로 변환합니다.
Public 메서드ConvertFromInvariantString(String)고정 문화권을 사용하여, 지정된 문자열을 이 변환기의 형식으로 변환합니다.
Public 메서드ConvertFromInvariantString(ITypeDescriptorContext, String)고정 문화권 및 지정된 컨텍스트를 사용하여 지정된 문자열을 이 변환기의 형식으로 변환합니다.
Public 메서드ConvertFromString(String)지정된 텍스트를 개체로 변환합니다.
Public 메서드ConvertFromString(ITypeDescriptorContext, String)지정된 컨텍스트를 사용하여, 지정된 텍스트를 개체로 변환합니다.
Public 메서드ConvertFromString(ITypeDescriptorContext, CultureInfo, String)지정된 컨텍스트 및 문화권 정보를 사용하여, 지정된 텍스트를 개체로 변환합니다.
Public 메서드ConvertTo(Object, Type)인수를 사용하여, 지정된 값 개체를 지정된 형식으로 변환합니다.
Public 메서드ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)지정된 컨텍스트 및 문화권 정보를 사용하여, 지정된 값 개체를 지정된 형식으로 변환합니다.
Public 메서드ConvertToInvariantString(Object)지정된 값을 고정 문화권의 문자열 표현으로 변환합니다.
Public 메서드ConvertToInvariantString(ITypeDescriptorContext, Object)지정된 context를 사용하여, 지정된 값을 고정 문화권의 문자열 표현으로 변환합니다.
Public 메서드ConvertToString(Object)지정된 값을 문자열 표현으로 변환합니다.
Public 메서드ConvertToString(ITypeDescriptorContext, Object)지정된 컨텍스트를 사용하여, 지정된 값을 문자열 표현으로 변환합니다.
Public 메서드ConvertToString(ITypeDescriptorContext, CultureInfo, Object)지정된 컨텍스트 및 문화권 정보를 사용하여, 지정된 값을 문자열 표현으로 변환합니다.
Public 메서드CreateInstance(IDictionary)개체의 속성 값 집합이 지정된 Object를 다시 만듭니다.
Public 메서드CreateInstance(ITypeDescriptorContext, IDictionary)개체의 속성 값 집합이 지정된 경우에는 지정된 컨텍스트를 사용하여 이 TypeConverter와 연관된 형식의 인스턴스를 만듭니다.
Public 메서드XNA Framework에서 지원Equals(Object) 지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)
Protected 메서드XNA Framework에서 지원Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Protected 메서드GetConvertFromException변환을 수행할 수 없을 때 throw되는 예외를 반환합니다.
Protected 메서드GetConvertToException변환을 수행할 수 없을 때 throw되는 예외를 반환합니다.
Public 메서드GetCreateInstanceSupported()이 개체의 값을 변경할 때 CreateInstance 메서드를 호출하여 새 값을 만들어야 하는지 여부를 반환합니다.
Public 메서드GetCreateInstanceSupported(ITypeDescriptorContext)이 개체의 값을 변경할 때 CreateInstance를 호출하여 지정된 컨텍스트로 새 값을 만들어야 하는지 여부를 반환합니다.
Public 메서드XNA Framework에서 지원GetHashCode기본 해시 함수로 작동합니다. (Object에서 상속됨)
Public 메서드GetProperties(Object)값 매개 변수로 지정된 배열 형식에 대한 속성 컬렉션을 반환합니다.
Public 메서드GetProperties(ITypeDescriptorContext, Object)지정된 컨텍스트를 사용하여, 값 매개 변수로 지정한 배열 형식에 대한 속성 컬렉션을 반환합니다.
Public 메서드GetProperties(ITypeDescriptorContext, Object, Attribute[])지정된 컨텍스트 및 특성을 사용하여, 값 매개 변수로 지정한 배열 형식에 대한 속성 컬렉션을 반환합니다.
Public 메서드GetPropertiesSupported()이 개체가 속성을 지원하는지 여부를 반환합니다.
Public 메서드GetPropertiesSupported(ITypeDescriptorContext)지정된 컨텍스트를 사용하여 이 개체가 속성을 지원하는지 여부를 반환합니다.
Public 메서드GetStandardValues()이 형식 변환기를 사용하도록 디자인된 데이터 형식의 기본 컨텍스트에서 표준 값 컬렉션을 반환합니다.
Public 메서드GetStandardValues(ITypeDescriptorContext)형식 컨텍스트가 제공될 때 이 형식 변환기를 사용하도록 디자인된 데이터 형식의 표준 값 컬렉션을 반환합니다.
Public 메서드GetStandardValuesExclusive() GetStandardValues 에서 반환된 표준 값 컬렉션이 단독 목록인지 여부를 반환합니다.
Public 메서드GetStandardValuesExclusive(ITypeDescriptorContext)지정된 컨텍스트를 사용하여, GetStandardValues에서 반환된 표준 값 컬렉션이 가능한 값을 모두 포함하는 단독 목록인지 여부를 반환합니다.
Public 메서드GetStandardValuesSupported()이 개체가 목록에서 선택할 수 있는 표준 값 집합을 지원하는지 여부를 반환합니다.
Public 메서드GetStandardValuesSupported(ITypeDescriptorContext)지정된 컨텍스트를 사용하여, 이 개체가 목록에서 선택할 수 있는 표준 값 집합을 지원하는지 여부를 반환합니다.
Public 메서드XNA Framework에서 지원GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드IsValid(Object)지정된 값 개체를 이 형식에 사용할 수 있는지 여부를 반환합니다.
Public 메서드IsValid(ITypeDescriptorContext, Object)지정된 값 개체를 이 형식 및 지정된 컨텍스트에 사용할 수 있는지 여부를 반환합니다.
Protected 메서드XNA Framework에서 지원MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Protected 메서드SortProperties속성 컬렉션을 정렬합니다.
Public 메서드XNA Framework에서 지원ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
위쪽

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

참고참고

일반 형식 시스템을 목적으로 형식 변환기를 직접 액세스하지 않습니다. 대신 TypeDescriptor를 사용하여 적절한 변환기에 액세스합니다. 자세한 내용은 제공되는 코드 예제를 참조하십시오.

참고   XAML 목적을 위해 XAML 프로세서는 TypeDescriptor를 통하는 대신 TypeConverterAttribute를 직접 검색합니다. 코드에서 TypeDescriptor 인스턴스를 원하는 경우 또는 WPF 리소스에서 공유 인스턴스를 만드는 경우 TypeDescriptor 또는 다른 리플렉션과 형식 시스템 지원을 참조하지 않고 직접 생성하는 것이 허용됩니다.

TypeConverter 에서 파생된 클래스는 XAML 프로세서가 특성 또는 태그(본질적으로 문자열)의 초기화 텍스트 값을 변환하고 개체를 런타임 표현으로 생성하는 방법의 일부로서 자주 참조됩니다. XAML에 대한 형식 변환 동작을 지원하는 사용자 지정 형식 작성자는 일반적으로 문자열에서 TypeConverter 동작을 지원하는 자체의 고유한 ConvertFrom 클래스를 구현합니다. 이 동작을 사용하면 XAML 특성 값으로 제공되는 문자열로부터 형식을 변환하고 XAML 프로세서에 문자열에서 개체를 만드는 데 필요한 지원을 제공할 수 있으므로 구문 분석된 개체 그래프에서 개체를 생성할 수 있습니다. 사용자 지정 형식 또는 사용자 지정 형식의 멤버는 사용자 지정 TypeConverter 구현을 참조하는 특성을 통해 정의에 TypeConverterAttribute를 적용하여 나타냅니다. 자세한 내용은 XAML을 위한 형식 변환기 개요를 참조하십시오.

참고참고

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

상속자 참고 사항

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

참고참고

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

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

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


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


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


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.
    }
 }


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


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


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


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


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


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


.NET Framework

4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows Phone 앱용 .NET

Windows Phone 8, Silverlight 8.1에서 지원

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

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

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

System.Object
  System.ComponentModel.TypeConverter
    Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter
    Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter
    System.Activities.XamlIntegration.AssemblyReferenceConverter
    System.Activities.XamlIntegration.DynamicUpdateMapConverter
    System.Activities.XamlIntegration.DynamicUpdateMapItemConverter
    System.Activities.XamlIntegration.ImplementationVersionConverter
    System.Activities.XamlIntegration.TypeConverterBase
    System.Activities.XamlIntegration.WorkflowIdentityConverter
    System.ComponentModel.BaseNumberConverter
    System.ComponentModel.BooleanConverter
    System.ComponentModel.CharConverter
    System.ComponentModel.CollectionConverter
    System.ComponentModel.CultureInfoConverter
    System.ComponentModel.DateTimeConverter
    System.ComponentModel.DateTimeOffsetConverter
    System.ComponentModel.EnumConverter
    System.ComponentModel.ExpandableObjectConverter
    System.ComponentModel.GuidConverter
    System.ComponentModel.MultilineStringConverter
    System.ComponentModel.NullableConverter
    System.ComponentModel.ReferenceConverter
    System.ComponentModel.StringConverter
    System.ComponentModel.TimeSpanConverter
    System.ComponentModel.TypeListConverter
    System.Configuration.ConfigurationConverterBase
    System.Diagnostics.Design.LogConverter
    System.Drawing.ColorConverter
    System.Drawing.FontConverter
    System.Drawing.FontConverter.FontNameConverter
    System.Drawing.ImageConverter
    System.Drawing.ImageFormatConverter
    System.Drawing.PointConverter
    System.Drawing.RectangleConverter
    System.Drawing.SizeConverter
    System.Drawing.SizeFConverter
    System.Resources.ResXFileRef.Converter
    System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicyTypeConverter
    System.ServiceModel.Discovery.Configuration.DiscoveryVersionConverter
    System.ServiceModel.XamlIntegration.EndpointIdentityConverter
    System.ServiceModel.XamlIntegration.ServiceXNameTypeConverter
    System.ServiceModel.XamlIntegration.XPathMessageContextTypeConverter
    System.UriTypeConverter
    System.Web.Configuration.LowerCaseStringConverter
    System.Web.UI.Design.DataBindingCollectionConverter
    System.Web.UI.Design.DataColumnSelectionConverter
    System.Web.UI.Design.DataFieldConverter
    System.Web.UI.Design.DataMemberConverter
    System.Web.UI.Design.DataSourceConverter
    System.Web.UI.Design.DataSourceViewSchemaConverter
    System.Web.UI.Design.ExpressionsCollectionConverter
    System.Web.UI.Design.MobileControls.Converters.DataFieldConverter
    System.Web.UI.Design.MobileControls.Converters.DataMemberConverter
    System.Web.UI.Design.SkinIDTypeConverter
    System.Web.UI.Design.WebControls.DataSourceIDConverter
    System.Web.UI.WebControls.FontNamesConverter
    System.Web.UI.WebControls.FontUnitConverter
    System.Web.UI.WebControls.StringArrayConverter
    System.Web.UI.WebControls.UnitConverter
    System.Windows.Controls.DataGridLengthConverter
    System.Windows.Controls.Ribbon.RibbonControlLengthConverter
    System.Windows.Controls.Ribbon.StringCollectionConverter
    System.Windows.Controls.VirtualizationCacheLengthConverter
    System.Windows.CornerRadiusConverter
    System.Windows.CultureInfoIetfLanguageTagConverter
    System.Windows.DeferrableContentConverter
    System.Windows.DialogResultConverter
    System.Windows.DurationConverter
    System.Windows.DynamicResourceExtensionConverter
    System.Windows.ExpressionConverter
    System.Windows.FigureLengthConverter
    System.Windows.FontSizeConverter
    System.Windows.FontStretchConverter
    System.Windows.FontStyleConverter
    System.Windows.FontWeightConverter
    System.Windows.Forms.AxHost.StateConverter
    System.Windows.Forms.CursorConverter
    System.Windows.Forms.DataGridPreferredColumnWidthTypeConverter
    System.Windows.Forms.DataGridViewCellStyleConverter
    System.Windows.Forms.KeysConverter
    System.Windows.Forms.Layout.TableLayoutSettingsTypeConverter
    System.Windows.Forms.LinkArea.LinkAreaConverter
    System.Windows.Forms.LinkConverter
    System.Windows.Forms.ListBindingConverter
    System.Windows.Forms.OpacityConverter
    System.Windows.Forms.PaddingConverter
    System.Windows.Forms.ScrollableControl.DockPaddingEdgesConverter
    System.Windows.Forms.SelectionRangeConverter
    System.Windows.Forms.TreeNodeConverter
    System.Windows.GridLengthConverter
    System.Windows.Input.CommandConverter
    System.Windows.Input.CursorConverter
    System.Windows.Input.InputScopeConverter
    System.Windows.Input.InputScopeNameConverter
    System.Windows.Input.KeyConverter
    System.Windows.Input.KeyGestureConverter
    System.Windows.Input.ModifierKeysConverter
    System.Windows.Input.MouseActionConverter
    System.Windows.Input.MouseGestureConverter
    System.Windows.Int32RectConverter
    System.Windows.KeySplineConverter
    System.Windows.KeyTimeConverter
    System.Windows.LengthConverter
    System.Windows.Markup.DependencyPropertyConverter
    System.Windows.Markup.EventSetterHandlerConverter
    System.Windows.Markup.NameReferenceConverter
    System.Windows.Markup.RoutedEventConverter
    System.Windows.Markup.SetterTriggerConditionValueConverter
    System.Windows.Markup.TemplateKeyConverter
    System.Windows.Markup.XmlLanguageConverter
    System.Windows.Media.Animation.RepeatBehaviorConverter
    System.Windows.Media.BrushConverter
    System.Windows.Media.CacheModeConverter
    System.Windows.Media.ColorConverter
    System.Windows.Media.Converters.BaseIListConverter
    System.Windows.Media.DoubleCollectionConverter
    System.Windows.Media.FontFamilyConverter
    System.Windows.Media.GeometryConverter
    System.Windows.Media.ImageSourceConverter
    System.Windows.Media.Int32CollectionConverter
    System.Windows.Media.MatrixConverter
    System.Windows.Media.Media3D.Matrix3DConverter
    System.Windows.Media.Media3D.Point3DCollectionConverter
    System.Windows.Media.Media3D.Point3DConverter
    System.Windows.Media.Media3D.Point4DConverter
    System.Windows.Media.Media3D.QuaternionConverter
    System.Windows.Media.Media3D.Rect3DConverter
    System.Windows.Media.Media3D.Size3DConverter
    System.Windows.Media.Media3D.Vector3DCollectionConverter
    System.Windows.Media.Media3D.Vector3DConverter
    System.Windows.Media.PathFigureCollectionConverter
    System.Windows.Media.PixelFormatConverter
    System.Windows.Media.PointCollectionConverter
    System.Windows.Media.RequestCachePolicyConverter
    System.Windows.Media.TransformConverter
    System.Windows.Media.VectorCollectionConverter
    System.Windows.PointConverter
    System.Windows.PropertyPathConverter
    System.Windows.RectConverter
    System.Windows.SizeConverter
    System.Windows.StrokeCollectionConverter
    System.Windows.TemplateBindingExpressionConverter
    System.Windows.TemplateBindingExtensionConverter
    System.Windows.TextDecorationCollectionConverter
    System.Windows.ThicknessConverter
    System.Windows.VectorConverter
    System.Workflow.ComponentModel.Design.ActivityBindTypeConverter
    System.Xaml.Schema.XamlTypeTypeConverter

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft