エクスポート (0) 印刷
すべて展開
この記事は機械翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 詳細情報
訳文
原文

TypeConverter クラス

値の型を他の型に変換し、標準値とサブプロパティにアクセスするための統一的な方法を提供します。

System.Object
  System.ComponentModel.TypeConverter
    詳細...

名前空間:  System.ComponentModel
アセンブリ:  System (System.dll 内)

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

TypeConverter 型で公開されるメンバーは以下のとおりです。

  名前説明
パブリック メソッドXNA Framework によるサポートTypeConverter TypeConverter クラスの新しいインスタンスを初期化します。
このページのトップへ

  名前説明
パブリック メソッドCanConvertFrom(Type)コンバーターが特定の型のオブジェクトをコンバーターの型に変換できるかどうかを示す値を返します。
パブリック メソッドCanConvertFrom(ITypeDescriptorContext, Type)指定したコンテキストを使用して、コンバーターが特定の型のオブジェクトをコンバーターの型に変換できるかどうかを示す値を返します。
パブリック メソッドCanConvertTo(Type)コンバーターがオブジェクトを指定した型に変換できるかどうかを示す値を返します。
パブリック メソッドCanConvertTo(ITypeDescriptorContext, Type)コンバーターが、指定したコンテキストを使用して、指定した型にオブジェクトを変換できるかどうかを示す値を返します。
パブリック メソッドConvertFrom(Object)指定した値をコンバーターの型に変換します。
パブリック メソッドConvertFrom(ITypeDescriptorContext, CultureInfo, Object)指定したコンテキストとカルチャ情報を使用して、指定したオブジェクトをコンバーターの型に変換します。
パブリック メソッドConvertFromInvariantString(String)インバリアント カルチャを使用して、指定した文字列をコンバーターの型に変換します。
パブリック メソッドConvertFromInvariantString(ITypeDescriptorContext, String)インバリアント カルチャと指定したコンテキストを使用して、指定した文字列をコンバーターの型に変換します。
パブリック メソッドConvertFromString(String)指定したテキストをオブジェクトに変換します。
パブリック メソッドConvertFromString(ITypeDescriptorContext, String)指定したコンテキストを使用して、指定したテキストをオブジェクトに変換します。
パブリック メソッドConvertFromString(ITypeDescriptorContext, CultureInfo, String)指定したコンテキストとカルチャ情報を使用して、指定したテキストをオブジェクトに変換します。
パブリック メソッドConvertTo(Object, Type)引数を使用して、指定した値オブジェクトを、指定した型に変換します。
パブリック メソッドConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)指定したコンテキストとカルチャ情報を使用して、指定した値オブジェクトを、指定した型に変換します。
パブリック メソッドConvertToInvariantString(Object)指定した値を、インバリアント カルチャを使用した文字列形式に変換します。
パブリック メソッドConvertToInvariantString(ITypeDescriptorContext, Object)指定したコンテキストを使用して、指定した値をインバリアント カルチャを使用した文字列形式に変換します。
パブリック メソッドConvertToString(Object)指定した値を文字列形式に変換します。
パブリック メソッドConvertToString(ITypeDescriptorContext, Object)指定したコンテキストを使用して、指定した値を文字列形式に変換します。
パブリック メソッドConvertToString(ITypeDescriptorContext, CultureInfo, Object)指定したコンテキストとカルチャ情報を使用して、指定した値を文字列形式に変換します。
パブリック メソッドCreateInstance(IDictionary) Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。
パブリック メソッドCreateInstance(ITypeDescriptorContext, IDictionary)指定したコンテキストを使用して、オブジェクトの一連のプロパティ値を指定し、TypeConverter に関連付けられている型のインスタンスを作成します。
パブリック メソッドXNA Framework によるサポートEquals(Object)指定のオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (Object から継承されます。)
プロテクト メソッドXNA Framework によるサポートFinalize オブジェクトがガベジ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッドGetConvertFromException変換を実行できなかった場合にスローされる例外を返します。
プロテクト メソッドGetConvertToException変換を実行できなかった場合にスローされる例外を返します。
パブリック メソッドGetCreateInstanceSupported()このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。
パブリック メソッドGetCreateInstanceSupported(ITypeDescriptorContext)このオブジェクトの値を変更するときに、指定したコンテキストを使用して CreateInstance を呼び出して、新しい値を作成する必要があるかどうかを返します。
パブリック メソッドXNA Framework によるサポートGetHashCode既定のハッシュ関数として機能します。 (Object から継承されます。)
パブリック メソッドGetProperties(Object)value パラメーターに指定された配列型のプロパティのコレクションを返します。
パブリック メソッドGetProperties(ITypeDescriptorContext, Object)指定したコンテキストを使用して、value パラメーターで指定された配列型のプロパティのコレクションを返します。
パブリック メソッドGetProperties(ITypeDescriptorContext, Object, Attribute[])指定したコンテキストと属性を使用して、value パラメーターで指定された配列型のプロパティのコレクションを返します。
パブリック メソッドGetPropertiesSupported()オブジェクトがプロパティをサポートしているかどうかを示す値を返します。
パブリック メソッドGetPropertiesSupported(ITypeDescriptorContext)指定したコンテキストを使用して、オブジェクトがプロパティをサポートしているかどうかを示す値を返します。
パブリック メソッドGetStandardValues()型コンバーターがデザインされた対象であるデータ型の既定のコンテキストから、標準値のコレクションを返します。
パブリック メソッドGetStandardValues(ITypeDescriptorContext)書式指定コンテキストが指定されている場合、型コンバーターがデザインされた対象のデータ型の標準値のコレクションを返します。
パブリック メソッドGetStandardValuesExclusive() GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。
パブリック メソッドGetStandardValuesExclusive(ITypeDescriptorContext)指定したコンテキストを使用して、GetStandardValues から返された標準値のコレクションが有効値の排他的なリストかどうかを示す値を返します。
パブリック メソッドGetStandardValuesSupported()リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。
パブリック メソッドGetStandardValuesSupported(ITypeDescriptorContext)指定したコンテキストを使用して、リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。
パブリック メソッドXNA Framework によるサポートGetType現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッドIsValid(Object)指定した値オブジェクトが型に対して有効かどうかを示す値を返します。
パブリック メソッドIsValid(ITypeDescriptorContext, Object)指定した値オブジェクトが、型および指定したコンテキストに対して有効かどうかを示す値を返します。
プロテクト メソッドXNA Framework によるサポートMemberwiseClone現在の Object の簡易コピーを作成します。 (Object から継承されます。)
プロテクト メソッドSortPropertiesプロパティのコレクションを並べ替えます。
パブリック メソッドXNA Framework によるサポートToString 現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)
このページのトップへ

最も一般的な型コンバーターは、テキスト形式への変換と、その逆の変換を行います。 クラスの型コンバーターは、TypeConverterAttribute を使用してそのクラスに関連付けられます。 この属性がオーバーライドされない限り、このクラスから継承されるすべてのクラスは、基本クラスと同じ型コンバーターを使用します。

メモメモ

汎用型システムの用途で、型コンバーターに直接アクセスすることは避けてください。 代わりに、TypeDescriptor を使用して、該当するコンバーターにアクセスします。 詳細については、コード例を参照してください。

メモ   XAML のため、XAML プロセッサは TypeDescriptor 全体の代わりに、TypeConverterAttribute を直接検索します。コードから TypeDescriptor インスタンスが必要な場合、または WPF リソースで共有インスタンスを作成する場合は、TypeDescriptor やその他のリフレクションや型システムのサポートを直接参照せずに、直接構築することもできます。

TypeConverter から派生するクラスは、多くの場合、XAML プロセッサが属性またはマークアップからの初期化文字列値 (本質的には文字列) を変換し、ランタイム表現のオブジェクトを生成する方法の一部として参照されます。 通常、XAML の型変換の動作をサポートするカスタム型の作成者は、文字列から独自の ConvertFrom をサポートする TypeConverter クラスを実装します。 この動作により、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

コミュニティの追加

追加
表示:
© 2015 Microsoft