データ フロー コンポーネントのデザイン時のメソッド

コンポーネントの開発者は、ProvideComponentProperties メソッドへの呼び出しで、カスタム プロパティ (IDTSCustomProperty100) をコンポーネントに追加する必要があります。カスタム プロパティにはデータ型プロパティがありません。カスタム プロパティのデータ型は、Value プロパティに割り当てた値のデータ型によって設定されます。ただし、カスタム プロパティに初期値を割り当てた後、別のデータ型の値を割り当てることはできません。

注
IDTSCustomProperty100 インターフェイスは、Object 型のプロパティ値を制限付きでサポートしています。カスタム プロパティの値として格納できるオブジェクトは、文字列や整数などの単純型の配列のみです。

次の例に示すように、カスタム プロパティの ExpressionType プロパティの値を、DTSCustomPropertyExpressionType 列挙値の CPET_NOTIFY に設定すると、カスタム プロパティでプロパティ式をサポートすることを指定できます。ユーザーによって入力されたプロパティ式を処理または検証するためのコードを追加する必要はありません。プロパティの既定値を設定し、値を検証し、値を読み取って正常に使用することができます。

  IDTSCustomProperty100 myCustomProperty;
  ...
  myCustomProperty.ExpressionType = DTSCustomPropertyExpressionType.CPET_NOTIFY;

  Dim myCustomProperty As IDTSCustomProperty100
  ...
  myCustomProperty.ExpressionType = DTSCustomPropertyExpressionType.CPET_NOTIFY

次の例に示すように、TypeConverter プロパティを使用して、カスタム プロパティ値を列挙値から選択すると、ユーザーを制限できます。この例では、あらかじめ MyValidValues という名前のパブリック列挙値が定義されているものとします。

  IDTSCustomProperty100 customProperty = outputColumn.CustomPropertyCollection.New();
  customProperty.Name = "My Custom Property";
  // This line associates the type with the custom property.
  customProperty.TypeConverter = typeof(MyValidValues).AssemblyQualifiedName;
  // Now you can use the enumeration values directly.
  customProperty.Value = MyValidValues.ValueOne;  

  Dim customProperty As IDTSCustomProperty100 = outputColumn.CustomPropertyCollection.New 
  customProperty.Name = "My Custom Property" 
  ' This line associates the type with the custom property.
  customProperty.TypeConverter = GetType(MyValidValues).AssemblyQualifiedName 
  ' Now you can use the enumeration values directly.
  customProperty.Value = MyValidValues.ValueOne

詳細については、MSDN ライブラリの「一般的な型変換」および「型コンバーターの実装」を参照してください。

次の例に示すように、UITypeEditor プロパティを使用すると、カスタム プロパティの値を設定するカスタム エディター ダイアログ ボックスを指定できます。ニーズに合った既存の UI 型エディターのクラスが見つからない場合は、最初に System.Drawing.Design.UITypeEditor を継承するカスタム型のエディターを作成する必要があります。

  public class MyCustomTypeEditor : UITypeEditor
  {
  ...
  }

Public Class MyCustomTypeEditor
  Inherits UITypeEditor 
  ...
End Class

次に、カスタム プロパティの UITypeEditor プロパティの値として、このクラスを指定します。

  IDTSCustomProperty100 customProperty = outputColumn.CustomPropertyCollection.New();
  customProperty.Name = "My Custom Property";
  // This line associates the editor with the custom property.
  customProperty.UITypeEditor = typeof(MyCustomTypeEditor).AssemblyQualifiedName;

  Dim customProperty As IDTSCustomProperty100 = outputColumn.CustomPropertyCollection.New 
  customProperty.Name = "My Custom Property" 
  ' This line associates the editor with the custom property.
  customProperty.UITypeEditor = GetType(MyCustomTypeEditor).AssemblyQualifiedName

詳細については、MSDN ライブラリの「UI 型エディターの実装」を参照してください。