Parameter.OnParameterChanged Methode

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält.

protected:
 void OnParameterChanged();

protected void OnParameterChanged ();

member this.OnParameterChanged : unit -> unit

Protected Sub OnParameterChanged ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die OnParameterChanged -Methode aufrufen, um das ParametersChanged Ereignis auszulösen, wenn sich der Zustand eines Parameters ändert. Dieses Codebeispiel ist Teil eines größeren Beispiels für die Parameter Klassenübersicht.

// 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

Hinweise

Wenn das Parameter Objekt nicht in einer ParameterCollection Auflistung enthalten ist, hat das Aufrufen der OnParameterChanged Methode keine Auswirkung. Wenn das Parameter Objekt in einer ParameterCollection Auflistung enthalten ist, OnParameterChanged löst das ParameterCollection.ParametersChanged Ereignis der Auflistung aus.

Wenn die ParameterCollection Auflistung in einem Datenquellensteuerelement enthalten ist, löst das ParameterCollection.ParametersChanged Ereignis das Ereignis des Datenquellensteuerelements DataSourceChanged aus, sodass alle datengebundenen Steuerelemente neu gebunden werden.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnParameterChanged-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Wenn Sie OnParameterChanged() in einer abgeleiteten Klasse überschreiben, müssen Sie die OnParameterChanged()-Methode der Basisklasse aufrufen, damit registrierte Delegaten das Ereignis empfangen.

Weitere Informationen

• ParametersChanged