Parameter.OnParameterChanged Méthode

Définition

Appelle la méthode OnParametersChanged(EventArgs) de la collection ParameterCollection qui contient l'objet Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

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' ParametersChanged événement lorsque l’état d’un paramètre change.The following code example demonstrates how to call the OnParameterChanged method to raise the ParametersChanged event when the state of a parameter changes. Cet exemple de code fait partie d’un exemple plus complet fourni Parameter pour la vue d’ensemble de la classe.This code example is part of a larger example provided for the Parameter class overview.

// 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' Parameter objet n’est pas contenu dans ParameterCollection une collection, l' OnParameterChanged appel de la méthode n’a aucun effet.If the Parameter object is not contained by a ParameterCollection collection, calling the OnParameterChanged method has no effect. Si l' Parameter objet est contenu dans une ParameterCollection collection, OnParameterChanged déclenche l' ParameterCollection.ParametersChanged événement de la collection.If the Parameter object is contained by a ParameterCollection collection, OnParameterChanged raises the ParameterCollection.ParametersChanged event of the collection.

Si la ParameterCollection collection est contenue dans un contrôle de source de ParameterCollection.ParametersChanged données, l’événement déclenche l’événement DataSourceChanged du contrôle de source de données, ce qui entraîne la reliaison des contrôles liés aux données.If the ParameterCollection collection is contained by a data source control, the ParameterCollection.ParametersChanged event raises the data source control's DataSourceChanged event, causing any data-bound controls to rebind.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué.Raising an event invokes the event handler through a delegate. Pour plus d’informations, consultez gestion et déclenchement d’événements.For more information, see Handling and Raising Events.

La méthode OnParameterChanged permet également aux classes dérivées de gérer l'événement sans y attacher de délégué.The OnParameterChanged method also allows derived classes to handle the event without attaching a delegate. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.This is the preferred technique for handling the event in a derived class.

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.When overriding OnParameterChanged() in a derived class, be sure to call the base class's OnParameterChanged() method so that registered delegates receive the event.

S’applique à

Voir aussi