ExpandableObjectConverter クラス

定義

拡張可能なオブジェクトのさまざまな表現への変換や、その逆の変換を行う型コンバーターを提供します。Provides a type converter to convert expandable objects to and from various other representations.

public ref class ExpandableObjectConverter : System::ComponentModel::TypeConverter
public class ExpandableObjectConverter : System.ComponentModel.TypeConverter
type ExpandableObjectConverter = class
    inherit TypeConverter
Public Class ExpandableObjectConverter
Inherits TypeConverter
継承
ExpandableObjectConverter
派生

次のコード例では、Margins 型の変数を文字列変数に変換します。The following code example converts a variable of type Margins to a string variable.

String^ strM = "1,2,3,4";
System::Drawing::Printing::Margins^ m = gcnew System::Drawing::Printing::Margins( 1,2,3,4 );
Console::WriteLine( TypeDescriptor::GetConverter( strM )->CanConvertTo( System::Drawing::Printing::Margins::typeid ) );
Console::WriteLine( TypeDescriptor::GetConverter( m )->ConvertToString( m ) );
string strM="1,2,3,4";
System.Drawing.Printing.Margins  m= new System.Drawing.Printing.Margins(1,2,3,4);
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(typeof(System.Drawing.Printing.Margins))); 
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m)); 
Dim strM As String
strM = "1,2,3,4"
            Dim m As New System.Drawing.Printing.Margins(1, 2, 3, 4)
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(GetType(System.Drawing.Printing.Margins)))
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m))

次のコード例は、NotifyParentPropertyAttributeExpandableObjectConverter クラスを使用して、カスタムコントロールに展開可能なプロパティを作成する方法を示しています。The following code example demonstrates how to use the NotifyParentPropertyAttribute and the ExpandableObjectConverter class to create an expandable property on a custom control. このコード例は、NotifyParentPropertyAttribute クラス用に用意されている大規模な例の一部です。This code example is part of a larger example provided for the NotifyParentPropertyAttribute class.

[TypeConverter(typeof(BorderAppearanceConverter))]
public class BorderAppearance
{
    private int borderSizeValue = 1;
    private Color borderColorValue = Color.Empty;

    [Browsable(true),
    NotifyParentProperty(true),
    EditorBrowsable(EditorBrowsableState.Always),
    DefaultValue(1)]
    public int BorderSize
    {
        get
        {
            return borderSizeValue;
        }
        set
        {
            if (value < 0)
            {
                throw new ArgumentOutOfRangeException(
                    "BorderSize",
                    value,
                    "must be >= 0");
            }

            if (borderSizeValue != value)
            {
                borderSizeValue = value;
            }
        }
    }

    [Browsable(true)]
    [NotifyParentProperty(true)]
    [EditorBrowsable(EditorBrowsableState.Always)]
    [DefaultValue(typeof(Color), "")]
    public Color BorderColor
    {
        get
        {
            return borderColorValue;
        }
        set
        {
            if (value.Equals(Color.Transparent))
            {
                throw new NotSupportedException("Transparent colors are not supported.");
            }

            if (borderColorValue != value)
            {
                borderColorValue = value;
            }
        }
    }
}
<TypeConverter(GetType(BorderAppearanceConverter))>  _
Public Class BorderAppearance
    Private borderSizeValue As Integer = 1
    Private borderColorValue As Color = Color.Empty
    
    
    <Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(1)>  _
    Public Property BorderSize() As Integer 
        Get
            Return borderSizeValue
        End Get
        Set
            If value < 0 Then
                Throw New ArgumentOutOfRangeException("BorderSize", value, "must be >= 0")
            End If
            
            If borderSizeValue <> value Then
                borderSizeValue = value
            End If
        End Set
    End Property
    
    
    <Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(GetType(Color), "")>  _
    Public Property BorderColor() As Color 
        Get
            Return borderColorValue
        End Get
        Set
            If value.Equals(Color.Transparent) Then
                Throw New NotSupportedException("Transparent colors are not supported.")
            End If
            
            If borderColorValue <> value Then
                borderColorValue = value
            End If
        End Set
    End Property
End Class

注釈

このクラスは、TypeConverterによって提供されるメソッドとプロパティに、オブジェクトのプロパティのサポートを追加します。This class adds support for properties on an object to the methods and properties provided by TypeConverter. PropertyGridでプロパティの型を展開できるようにするには、GetPropertiesSupportedGetPropertiesの標準実装に対して、この TypeConverter を指定します。To make a type of property expandable in the PropertyGrid, specify this TypeConverter for standard implementations of GetPropertiesSupported and GetProperties. PropertyGrid コントロールで正しい動作を保証するには、子プロパティを NotifyParentPropertyAttribute でマークします。Mark child properties with the NotifyParentPropertyAttribute to ensure correct behavior in a PropertyGrid control.

注意

型コンバーターに直接アクセスすることはできません。You should never access a type converter directly. 代わりに、TypeDescriptorを使用して適切なコンバーターを呼び出します。Instead, call the appropriate converter by using TypeDescriptor. 詳細については、TypeConverter 基本クラスの例を参照してください。For more information, see the examples in the TypeConverter base class.

型コンバーターの詳細については、「TypeConverter 基底クラス」と「方法: 型コンバーターを実装する」を参照してください。For more information about type converters, see the TypeConverter base class and How to: Implement a Type Converter.

コンストラクター

ExpandableObjectConverter()

ExpandableObjectConverter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ExpandableObjectConverter class.

メソッド

CanConvertFrom(ITypeDescriptorContext, Type)

このコンバーターが、指定したコンテキストを使用して、指定された型のオブジェクトをこのコンバーターの型に変換できるかどうかを返します。Returns whether this converter can convert an object of the given type to the type of this converter, using the specified context.

(継承元 TypeConverter)
CanConvertFrom(Type)

コンバーターが特定の型のオブジェクトをコンバーターの型に変換できるかどうかを示す値を返します。Returns whether this converter can convert an object of the given type to the type of this converter.

(継承元 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

このコンバーターが指定のコンテキストを使用して、オブジェクトを指定の型に変換できるかどうかを返します。Returns whether this converter can convert the object to the specified type, using the specified context.

(継承元 TypeConverter)
CanConvertTo(Type)

コンバーターがオブジェクトを指定した型に変換できるかどうかを示す値を返します。Returns whether this converter can convert the object to the specified type.

(継承元 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

指定したコンテキストとカルチャ情報を使用して、指定したオブジェクトをこのコンバーターの型に変換します。Converts the given object to the type of this converter, using the specified context and culture information.

(継承元 TypeConverter)
ConvertFrom(Object)

指定した値をコンバーターの型に変換します。Converts the given value to the type of this converter.

(継承元 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

インバリアント カルチャと指定したコンテキストを使用して、指定した文字列をコンバーターの型に変換します。Converts the given string to the type of this converter, using the invariant culture and the specified context.

(継承元 TypeConverter)
ConvertFromInvariantString(String)

インバリアント カルチャを使用して、指定した文字列をコンバーターの型に変換します。Converts the given string to the type of this converter, using the invariant culture.

(継承元 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

指定したコンテキストとカルチャ情報を使用して、指定したテキストをオブジェクトに変換します。Converts the given text to an object, using the specified context and culture information.

(継承元 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

指定したコンテキストを使用して、指定したテキストをオブジェクトに変換します。Converts the given text to an object, using the specified context.

(継承元 TypeConverter)
ConvertFromString(String)

指定したテキストをオブジェクトに変換します。Converts the specified text to an object.

(継承元 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

指定したコンテキストとカルチャ情報を使用して、指定した値オブジェクトを指定した型に変換します。Converts the given value object to the specified type, using the specified context and culture information.

(継承元 TypeConverter)
ConvertTo(Object, Type)

引数を使用して、指定した値オブジェクトを、指定した型に変換します。Converts the given value object to the specified type, using the arguments.

(継承元 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

指定したコンテキストを使用して、指定した値をインバリアント カルチャを使用した文字列形式に変換します。Converts the specified value to a culture-invariant string representation, using the specified context.

(継承元 TypeConverter)
ConvertToInvariantString(Object)

指定した値を、インバリアント カルチャを使用した文字列形式に変換します。Converts the specified value to a culture-invariant string representation.

(継承元 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

指定したコンテキストとカルチャ情報を使用して、指定した値を文字列形式に変換します。Converts the given value to a string representation, using the specified context and culture information.

(継承元 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

指定したコンテキストを使用して、指定した値を文字列形式に変換します。Converts the given value to a string representation, using the given context.

(継承元 TypeConverter)
ConvertToString(Object)

指定した値を文字列形式に変換します。Converts the specified value to a string representation.

(継承元 TypeConverter)
CreateInstance(IDictionary)

Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。Re-creates an Object given a set of property values for the object.

(継承元 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

この TypeConverter を関連付ける型のインスタンスを作成します。指定されたコンテキストと、与えられているオブジェクトのプロパティ値のセットを使用します。Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.

(継承元 TypeConverter)
Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetConvertFromException(Object)

変換を実行できないときにスローする例外を返します。Returns an exception to throw when a conversion cannot be performed.

(継承元 TypeConverter)
GetConvertToException(Object, Type)

変換を実行できないときにスローする例外を返します。Returns an exception to throw when a conversion cannot be performed.

(継承元 TypeConverter)
GetCreateInstanceSupported()

このオブジェクトの値を変更するときに CreateInstance(IDictionary) メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value.

(継承元 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

このオブジェクトの値を変更するときに、指定したコンテキストを使用して CreateInstance(IDictionary) を呼び出して、新しい値を作成する必要があるかどうかを返します。Returns whether changing a value on this object requires a call to CreateInstance(IDictionary) to create a new value, using the specified context.

(継承元 TypeConverter)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetProperties(ITypeDescriptorContext, Object)

指定したコンテキストを使用して、value パラメーターで指定された配列型のプロパティのコレクションを返します。Returns a collection of properties for the type of array specified by the value parameter, using the specified context.

(継承元 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

value パラメーターに指定されたオブジェクト型のプロパティのコレクションを取得します。Gets a collection of properties for the type of object specified by the value parameter.

GetProperties(Object)

value パラメーターに指定された配列型のプロパティのコレクションを返します。Returns a collection of properties for the type of array specified by the value parameter.

(継承元 TypeConverter)
GetPropertiesSupported()

オブジェクトがプロパティをサポートしているかどうかを示す値を返します。Returns whether this object supports properties.

(継承元 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

指定したコンテキストを使用して、オブジェクトがプロパティをサポートしているかどうかを示す値を取得します。Gets a value indicating whether this object supports properties using the specified context.

GetStandardValues()

型コンバーターがデザインされた対象であるデータ型の既定のコンテキストから、標準値のコレクションを返します。Returns a collection of standard values from the default context for the data type this type converter is designed for.

(継承元 TypeConverter)
GetStandardValues(ITypeDescriptorContext)

フォーマット コンテキストが提供されている場合、この型コンバーターが対象とするデータ型の標準値のコレクションを返します。Returns a collection of standard values for the data type this type converter is designed for when provided with a format context.

(継承元 TypeConverter)
GetStandardValuesExclusive()

GetStandardValues() から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list.

(継承元 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

指定したコンテキストを使用して、GetStandardValues() から返された標準値のコレクションが有効値の排他的なリストかどうかを示す値を返します。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context.

(継承元 TypeConverter)
GetStandardValuesSupported()

このオブジェクトが、一覧から選択できる標準的な値のセットをサポートするかどうかを返します。Returns whether this object supports a standard set of values that can be picked from a list.

(継承元 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

指定したコンテキストを使用して、リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。Returns whether this object supports a standard set of values that can be picked from a list, using the specified context.

(継承元 TypeConverter)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IsValid(ITypeDescriptorContext, Object)

指定した値オブジェクトが、この型に対して有効か、指定したコンテキストに対して有効かを返します。Returns whether the given value object is valid for this type and for the specified context.

(継承元 TypeConverter)
IsValid(Object)

指定した値オブジェクトが型に対して有効かどうかを示す値を返します。Returns whether the given value object is valid for this type.

(継承元 TypeConverter)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
SortProperties(PropertyDescriptorCollection, String[])

プロパティのコレクションを並べ替えます。Sorts a collection of properties.

(継承元 TypeConverter)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象

こちらもご覧ください