Parameter.OnParameterChanged Metodo

Definizione

Chiame il metodo OnParametersChanged(EventArgs) dell'insieme ParameterCollection che contiene l'oggetto Parameter.

protected:
 void OnParameterChanged();
protected void OnParameterChanged ();
member this.OnParameterChanged : unit -> unit
Protected Sub OnParameterChanged ()

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il OnParameterChanged metodo per generare l'evento ParametersChanged quando lo stato di un parametro viene modificato. Questo esempio di codice fa parte di un esempio più ampio fornito per la panoramica della 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

Commenti

Se l'oggetto Parameter non è contenuto in un ParameterCollection insieme, la chiamata al OnParameterChanged metodo non ha alcun effetto. Se l'oggetto Parameter è contenuto in un ParameterCollection insieme, OnParameterChanged genera l'evento ParameterCollection.ParametersChanged della raccolta.

Se la ParameterCollection raccolta è contenuta in un controllo origine dati, l'evento ParameterCollection.ParametersChanged genera l'evento del DataSourceChanged controllo origine dati, causando la riassociazione di eventuali controlli associati a dati.

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato. Per altre informazioni, vedere la gestione e generazione di eventi.

Il metodo OnParameterChanged consente inoltre alle classi derivate di gestire l'evento senza associare un delegato. È la tecnica consigliata per la gestione dell'evento in una classe derivata.

Note per gli eredi

Quando si esegue l'override di OnParameterChanged() in una classe derivata, verificare di chiamare il metodo OnParameterChanged() della classe di base in modo che i delegati registrati ricevano l'evento.

Si applica a

Vedi anche