Parameter.OnParameterChanged Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitProtected 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.
