Parameter.OnParameterChanged Méthode

protected:
 void OnParameterChanged();

protected void OnParameterChanged ();

member this.OnParameterChanged : unit -> unit

Protected 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.

S’applique à

Voir aussi

• ParametersChanged