Parameter.OnParameterChanged メソッド

定義

OnParametersChanged(EventArgs) オブジェクトを格納する ParameterCollection コレクションの Parameter メソッドを呼び出します。

protected:
 void OnParameterChanged();
protected void OnParameterChanged ();
member this.OnParameterChanged : unit -> unit
Protected Sub OnParameterChanged ()

次のコード例では、 メソッドを呼び出して、 OnParameterChanged パラメーターの状態が ParametersChanged 変化したときにイベントを発生させる方法を示します。 このコード例は、クラスの概要に関するより大きな例の Parameter 一部です。

// The Value property is a type safe convenience property
// used when the StaticParameter represents string data.
// It gets the string value of the DataValue property, and
// sets the DataValue property directly.
public string Value {
  get {
    object o = DataValue;
    if (o == null || !(o is string))
      return String.Empty;
    return (string)o;
  }
  set {
    DataValue = value;
    OnParameterChanged();
  }
}
' The Value property is a type safe convenience property
' used when the StaticParameter represents string data.
' It gets the string value of the DataValue property, and
' sets the DataValue property directly.
Public Property Value() As String
   Get
      Dim o As Object = DataValue
      If o Is Nothing OrElse Not TypeOf o Is String Then
         Return String.Empty
      End If
      Return CStr(o)
   End Get
   Set
      DataValue = value
      OnParameterChanged()
   End Set
End Property

注釈

オブジェクトがコレクションにParameterParameterCollection含まれていない場合、 メソッドをOnParameterChanged呼び出しても効果はありません。 オブジェクトが Parameter コレクションに ParameterCollection 含まれている場合は、 OnParameterChanged コレクションの イベントを ParameterCollection.ParametersChanged 発生させます。

コレクションが ParameterCollection データ ソース コントロールに含まれている場合、イベントによって ParameterCollection.ParametersChanged データ ソース コントロールの DataSourceChanged イベントが発生し、データ バインド コントロールが再バインドされます。

イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。 詳細については、処理とイベントの発生 を参照してください。

OnParameterChanged メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。 派生クラスでイベントを処理する場合は、この手法をお勧めします。

注意 (継承者)

派生クラスで OnParameterChanged() をオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnParameterChanged() メソッドを呼び出してください。

適用対象

こちらもご覧ください