Parameter.OnParameterChanged Parameter.OnParameterChanged Parameter.OnParameterChanged Parameter.OnParameterChanged Method

Definition

Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die OnParameterChanged -Methode aufgerufen wird ParametersChanged , um das-Ereignis zu erhöhen, wenn sich der Status eines Parameters ändert.The following code example demonstrates how to call the OnParameterChanged method to raise the ParametersChanged event when the state of a parameter changes. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Parameter Klassen Übersicht bereitgestellt wird.This code example is part of a larger example provided for the Parameter class overview.

// 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 der OnParameterChanged Aufruf der-Methode keine Auswirkungen.If the Parameter object is not contained by a ParameterCollection collection, calling the OnParameterChanged method has no effect. Wenn das Parameter Objekt in einer ParameterCollection Auflistung enthalten ist, OnParameterChanged löst das ParameterCollection.ParametersChanged -Ereignis der-Auflistung aus.If the Parameter object is contained by a ParameterCollection collection, OnParameterChanged raises the ParameterCollection.ParametersChanged event of the collection.

Wenn die ParameterCollection Auflistung in einem Datenquellen-Steuerelement enthalten ist ParameterCollection.ParametersChanged , löst das-Ereignis das- DataSourceChanged Ereignis des Datenquellen-Steuer Elements aus, sodass alle Daten gebundenen Steuerelemente erneut gebunden werden.If the ParameterCollection collection is contained by a data source control, the ParameterCollection.ParametersChanged event raises the data source control's DataSourceChanged event, causing any data-bound controls to rebind.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen.Raising an event invokes the event handler through a delegate. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.For more information, see Handling and Raising Events.

Mit der OnParameterChanged-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln.The OnParameterChanged method also allows derived classes to handle the event without attaching a delegate. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.This is the preferred technique for handling the event in a derived class.

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.When overriding OnParameterChanged() in a derived class, be sure to call the base class's OnParameterChanged() method so that registered delegates receive the event.

Gilt für:

Siehe auch