Parameter.OnParameterChanged Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывает метод OnParametersChanged(EventArgs) коллекции ParameterCollection, содержащей объект Parameter.
protected:
void OnParameterChanged();
protected void OnParameterChanged ();
member this.OnParameterChanged : unit -> unit
Protected Sub OnParameterChanged ()
Примеры
В следующем примере кода показано, как вызвать OnParameterChanged метод для вызова ParametersChanged события при изменении состояния параметра. Этот пример кода является частью более крупного примера, предоставленного Parameter для обзора класса.
// 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 влияния. Parameter Если объект содержится в ParameterCollection коллекции, OnParameterChanged вызывает ParameterCollection.ParametersChanged событие коллекции.
ParameterCollection Если коллекция содержится в элементе управления источником данных, ParameterCollection.ParametersChanged событие вызывает событие элемента управления DataSourceChanged источником данных, вызывая повторную привязку всех элементов управления с привязкой к данным.
При возникновении события через делегат вызывается обработчик события. Дополнительные сведения см. в разделе Обработка и вызов событий.
Метод OnParameterChanged также позволяет производным классам обрабатывать событие, не присоединяя делегат. Это предпочтительная методика обработки событий в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении метода OnParameterChanged() в производном классе нужно убедиться, что вызывается метод OnParameterChanged() базового класса, чтобы зарегистрированные делегаты получили событие.