Parameter.OnParameterChanged Метод

Определение

Вызывает метод OnParametersChanged(EventArgs) коллекции ParameterCollection, содержащей объект 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 ()

Примеры

В следующем примере кода показано, как вызвать OnParameterChanged метод, чтобы вызвать ParametersChanged событие при изменении состояния параметра.The following code example demonstrates how to call the OnParameterChanged method to raise the ParametersChanged event when the state of a parameter changes. Этот пример кода является частью большого примера, приведенного в разделе Parameter Общие сведения о классе.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

Комментарии

Если Parameter объект не содержится в ParameterCollection коллекции, вызов метода не оказывает никакого OnParameterChanged влияния.If the Parameter object is not contained by a ParameterCollection collection, calling the OnParameterChanged method has no effect. Если Parameter объект содержится в ParameterCollection коллекции, OnParameterChanged вызывает ParameterCollection.ParametersChanged событие коллекции.If the Parameter object is contained by a ParameterCollection collection, OnParameterChanged raises the ParameterCollection.ParametersChanged event of the collection.

Если ParameterCollection Коллекция содержится в элементе управления источниками данных, ParameterCollection.ParametersChanged событие вызывает событие элемента управления источником данных, в DataSourceChanged результате чего все элементы управления с привязкой к данным перевязываются.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.

При возникновении события через делегат вызывается обработчик события.Raising an event invokes the event handler through a delegate. Дополнительные сведения см. в разделе обработка и вызов событий.For more information, see Handling and Raising Events.

Метод OnParameterChanged также позволяет производным классам обрабатывать событие, не присоединяя делегат.The OnParameterChanged method also allows derived classes to handle the event without attaching a delegate. Это предпочтительная методика обработки событий в производном классе.This is the preferred technique for handling the event in a derived class.

Примечания для тех, кто наследует этот метод

При переопределении метода OnParameterChanged() в производном классе нужно убедиться, что вызывается метод OnParameterChanged() базового класса, чтобы зарегистрированные делегаты получили событие.When overriding OnParameterChanged() in a derived class, be sure to call the base class's OnParameterChanged() method so that registered delegates receive the event.

Применяется к

См. также раздел