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 die OnParameterChanged Methode aufgerufen wird, um das ParametersChanged Ereignis auszuheben, wenn sich der Status eines Parameters ändert. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Parameter Klassenübersicht bereitgestellt wird.
// 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 Ereignis das ParameterCollection.ParametersChanged Ereignis des Datenquellensteuerelements DataSourceChanged aus, wodurch datengebundene Steuerelemente neu gebunden werden.
Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.
Mit der OnParameterChanged Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Vererber
Achten Sie beim Überschreiben OnParameterChanged() in einer abgeleiteten Klasse darauf, die Methode der Basisklasse OnParameterChanged() aufzurufen, damit registrierte Stellvertretungen das Ereignis empfangen.