DependencyObject.AddHandler(DependencyProperty, Object) Método
Definição
Adiciona um manipulador para um evento de um DependencyObject.Adds a handler for an event of a DependencyObject.
public:
void AddHandler(System::Workflow::ComponentModel::DependencyProperty ^ dependencyEvent, System::Object ^ value);
public void AddHandler (System.Workflow.ComponentModel.DependencyProperty dependencyEvent, object value);
member this.AddHandler : System.Workflow.ComponentModel.DependencyProperty * obj -> unit
Public Sub AddHandler (dependencyEvent As DependencyProperty, value As Object)
Parâmetros
- dependencyEvent
- DependencyProperty
- value
- Object
O Object que representa o valor dessa propriedade.The Object that represents the value of this property. Nesse caso, um tipo Delegate.In this case, a Delegate type.
Exceções
Um dos argumentos é uma referência nula (Nothing no Visual Basic).Either of the arguments is a null reference (Nothing in Visual Basic).
O valor é do Type incorretoValue is of incorrect Type
- ou --or-
O dependencyEvent representa uma DependencyProperty não evento.The dependencyEvent represents a non-event DependencyProperty.
Exemplos
Os manipuladores são adicionados e removidos usando o código a seguir.Handlers are added and removed using the following code. Este exemplo de código faz parte do exemplo de SDK de envio de email e é do arquivo SendMailActivity. cs.This code example is part of the Send Email SDK sample and is from the SendMailActivity.cs file. Para obter mais informações, consulte Enviar exemplo de atividade de email.For more information, see Send Email Activity Sample.
#region Public Events
[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
[Description("The SendingEmail event is raised before an email is sent through SMTP.")]
[Category(EventsCategory)]
[Browsable(true)]
public event EventHandler SendingEmail
{
add
{
base.AddHandler(SendEmailActivity.SendingEmailEvent, value);
}
remove
{
base.RemoveHandler(SendEmailActivity.SendingEmailEvent, value);
}
}
#Region "Public Events"
<DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)> _
<Description("The SendingEmail event is raised before an email is sent through SMTP.")> _
<Category(EventsCategory)> _
<Browsable(True)> _
Public Custom Event SendingEmail As EventHandler
AddHandler(ByVal value As EventHandler)
MyBase.AddHandler(SendEmailActivity.SendingEmailEvent, value)
End AddHandler
RemoveHandler(ByVal value As EventHandler)
MyBase.RemoveHandler(SendEmailActivity.SendingEmailEvent, value)
End RemoveHandler
RaiseEvent(ByVal sender As Object, ByVal e As System.EventArgs)
End RaiseEvent
End Event
Comentários
Ao criar um delegado, você identifica o método que manipula o evento.When you create a delegate, you identify the method that handles the event. Para associar o evento ao manipulador de eventos, adicione uma instância do delegado ao evento.To associate the event with your event handler, add an instance of the delegate to the event. A menos que você remova o delegado, o manipulador de eventos é chamado sempre que o evento ocorre.Unless you remove the delegate, the event handler is called whenever the event occurs. Vários representantes podem ser adicionados para manipular um evento.Multiple delegates can be added to handle an event. Para obter mais informações sobre delegados de manipulador de eventos, consulte manipulando e gerando eventos.For more information about event-handler delegates, see Handling and Raising Events.