Parameter.OnParameterChanged Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Appelle la méthode OnParametersChanged(EventArgs) de la collection ParameterCollection qui contient l'objet Parameter.
protected:
void OnParameterChanged();protected void OnParameterChanged ();member this.OnParameterChanged : unit -> unitProtected Sub OnParameterChanged ()Exemples
L’exemple de code suivant montre comment appeler la OnParameterChanged méthode pour déclencher l’événement ParametersChanged lorsque l’état d’un paramètre change. Cet exemple de code fait partie d’un exemple plus large fourni pour la vue d’ensemble de la Parameter classe.
// 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
Remarques
Si l’objet Parameter n’est pas contenu par une ParameterCollection collection, l’appel de la OnParameterChanged méthode n’a aucun effet. Si l’objet Parameter est contenu par une ParameterCollection collection, OnParameterChanged déclenche l’événement ParameterCollection.ParametersChanged de la collection.
Si la ParameterCollection collection est contenue par un contrôle de source de données, l’événement ParameterCollection.ParametersChanged déclenche l’événement du contrôle de source de DataSourceChanged données, ce qui entraîne la rebinaison de tous les contrôles liés aux données.
Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué. Pour plus d’informations, consultez gestion et déclenchement d’événements.
La méthode OnParameterChanged permet également aux classes dérivées de gérer l'événement sans y attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.
Notes pour les héritiers
Lors de la substitution de OnParameterChanged() dans une classe dérivée, veillez à appeler la méthode OnParameterChanged() de la classe de base de manière à ce que les délégués inscrits reçoivent l'événement.
