Parameter.OnParameterChanged Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Llama al OnParametersChanged(EventArgs) método de la ParameterCollection colección que contiene el Parameter objeto .
protected:
void OnParameterChanged();protected void OnParameterChanged();member this.OnParameterChanged : unit -> unitProtected Sub OnParameterChanged ()Ejemplos
En el ejemplo de código siguiente se muestra cómo llamar al OnParameterChanged método para generar el ParametersChanged evento cuando cambia el estado de un parámetro. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la información general de la Parameter clase.
// 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
Comentarios
Si un Parameter objeto no está contenido en una ParameterCollection colección, llamar al OnParameterChanged método no tiene ningún efecto. Si el Parameter objeto está contenido en una ParameterCollection colección, OnParameterChanged genera el ParameterCollection.ParametersChanged evento de la colección.
Si la ParameterCollection colección está contenida en un control de origen de datos, el ParameterCollection.ParametersChanged evento genera el evento del control de DataSourceChanged origen de datos, lo que hace que los controles enlazados a datos se vuelvan a enlazar.
La generación de un evento invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte Control y generación de eventos.
El OnParameterChanged método también permite que las clases derivadas controle el evento sin adjuntar un delegado. Esta es la técnica preferida para controlar el evento en una clase derivada.
Notas a los desarrolladores de herederos
Al invalidar OnParameterChanged() en una clase derivada, asegúrese de llamar al método de OnParameterChanged() la clase base para que los delegados registrados reciban el evento.