Parameter.OnParameterChanged Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Chama o método OnParametersChanged(EventArgs) da coleção ParameterCollection que contém o objeto Parameter.
protected:
void OnParameterChanged();
protected void OnParameterChanged ();
member this.OnParameterChanged : unit -> unit
Protected Sub OnParameterChanged ()
Exemplos
O exemplo de código a seguir demonstra como chamar o OnParameterChanged método para gerar o ParametersChanged evento quando o estado de um parâmetro é alterado. Este exemplo de código faz parte de um exemplo maior fornecido para a visão geral da 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
Comentários
Se o Parameter objeto não estiver contido em uma ParameterCollection coleção, chamar o OnParameterChanged método não terá efeito. Se o Parameter objeto estiver contido em uma ParameterCollection coleção, OnParameterChanged gerará o ParameterCollection.ParametersChanged evento da coleção.
Se a ParameterCollection coleção estiver contida por um controle de fonte de dados, o ParameterCollection.ParametersChanged evento aciona o evento do controle da DataSourceChanged fonte de dados, fazendo com que todos os controles associados a dados sejam reassociados.
A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e gerando eventos.
O OnParameterChanged método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.
Notas aos Herdeiros
Ao substituir OnParameterChanged() em uma classe derivada, chame o método da OnParameterChanged() classe base para que os delegados registrados recebam o evento.