Parameter.OnParameterChanged 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

呼叫 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

備註

Parameter如果物件未包含在集合中 ParameterCollection ，則呼叫 OnParameterChanged 方法沒有任何作用。 Parameter如果物件是由 ParameterCollection 集合所包含， OnParameterChanged 則引發 ParameterCollection.ParametersChanged 集合的事件。

ParameterCollection如果集合是由資料來源控制項所包含，則 ParameterCollection.ParametersChanged 事件會引發資料來源控制項的事件 DataSourceChanged ，導致任何資料系結控制項重新系結。

引發事件會透過委派叫用此事件處理常式。 如需詳細資訊，請參閱 處理和引發事件。

OnParameterChanged 方法也允許衍生類別處理事件，而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。

給繼承者的注意事項

當在衍生類別中覆寫 OnParameterChanged() 時，請確定呼叫基底類別的 OnParameterChanged() 方法，使已註冊的委派能接收到事件。

另請參閱

• ParametersChanged