Parameter.OnParameterChanged Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Roept de OnParametersChanged(EventArgs) methode aan van de ParameterCollection verzameling die het Parameter object bevat.
protected:
void OnParameterChanged();protected void OnParameterChanged();member this.OnParameterChanged : unit -> unitProtected Sub OnParameterChanged ()Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de OnParameterChanged methode aanroept om de ParametersChanged gebeurtenis te genereren wanneer de status van een parameter wordt gewijzigd. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor het Parameter klasseoverzicht.
// 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
Opmerkingen
Als het Parameter object niet is opgenomen in een ParameterCollection verzameling, heeft het aanroepen van de OnParameterChanged methode geen effect. Als het Parameter object is opgenomen in een ParameterCollection verzameling, OnParameterChanged wordt de ParameterCollection.ParametersChanged gebeurtenis van de verzameling gegenereerd.
Als de ParameterCollection verzameling is opgenomen in een gegevensbronbesturingselement, wordt de ParameterCollection.ParametersChanged gebeurtenis van DataSourceChanged het gegevensbronbesturingselement gegenereerd, waardoor alle besturingselementen die afhankelijk zijn, opnieuw worden samengevoegd.
Als u een gebeurtenis aanroept, wordt de gebeurtenis-handler via een gemachtigde aangeroepen. Zie Afhandeling en het genereren van gebeurtenissen voor meer informatie.
Met OnParameterChanged de methode kunnen afgeleide klassen de gebeurtenis ook verwerken zonder een gemachtigde te koppelen. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een afgeleide klasse.
Notities voor overnemers
Wanneer u OnParameterChanged() overschrijft in een afgeleide klasse, moet u de methode van OnParameterChanged() de basisklasse aanroepen, zodat geregistreerde gemachtigden de gebeurtenis ontvangen.