ComponentChangedEventHandler-Delegat

Artikel
08/20/2007

Stellt die Methode dar, die ein ComponentChanged-Ereignis behandelt.

Namespace: System.ComponentModel.Design
Assembly: System (in system.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Delegate Sub ComponentChangedEventHandler ( _
    sender As Object, _
    e As ComponentChangedEventArgs _
)
'Usage
Dim instance As New ComponentChangedEventHandler(AddressOf HandlerMethod)

[ComVisibleAttribute(true)] 
public delegate void ComponentChangedEventHandler (
    Object sender,
    ComponentChangedEventArgs e
)

[ComVisibleAttribute(true)] 
public delegate void ComponentChangedEventHandler (
    Object^ sender, 
    ComponentChangedEventArgs^ e
)

/** @delegate */
/** @attribute ComVisibleAttribute(true) */ 
public delegate void ComponentChangedEventHandler (
    Object sender, 
    ComponentChangedEventArgs e
)

JScript unterstützt die Verwendung von Delegaten, aber nicht die Deklaration von neuen Delegaten.

Parameter

sender
Die Quelle des Ereignisses.

e
Ein ComponentChangedEventArgs, das die Ereignisdaten enthält.

Hinweise

Beim Erstellen eines ComponentChangedEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen über Ereignishandlerdelegaten finden Sie unter Ereignisse und Delegaten.

Beim Laden oder Entladen eines Formulars tritt kein ComponentChanged-Ereignis ein, da Änderungen bei diesen Operationen erwartet werden.

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Beispiel

In diesem Beispiel wird die Registrierung eines ComponentChangedEventHandler und die Behandlung eines ComponentChanged-Ereignisses veranschaulicht.

Public Sub LinkComponentChangedEvent(ByVal changeService As IComponentChangeService)
    ' Registers an event handler for the ComponentChanged event.
    AddHandler changeService.ComponentChanged, AddressOf Me.OnComponentChanged
End Sub

Private Sub OnComponentChanged(ByVal sender As Object, ByVal e As ComponentChangedEventArgs)
    ' Displays changed component information on the console.            
    Console.WriteLine(("Type of the component that has changed: " + e.Component.GetType().FullName))
    Console.WriteLine(("Name of the member of the component that has changed: " + e.Member.Name))
    Console.WriteLine(("Old value of the member: " + e.OldValue.ToString()))
    Console.WriteLine(("New value of the member: " + e.NewValue.ToString()))
End Sub

public void LinkComponentChangedEvent(IComponentChangeService changeService)
{
    // Registers an event handler for the ComponentChanged event.
    changeService.ComponentChanged += new ComponentChangedEventHandler(this.OnComponentChanged);            
}

private void OnComponentChanged(object sender, ComponentChangedEventArgs e)
{
    // Displays changed component information on the console.
    Console.WriteLine("Type of the component that has changed: "+e.Component.GetType().FullName);      
    Console.WriteLine("Name of the member of the component that has changed: "+e.Member.Name);            
    Console.WriteLine("Old value of the member: "+e.OldValue.ToString());
    Console.WriteLine("New value of the member: "+e.NewValue.ToString());
}

public:
   void LinkComponentChangedEvent( IComponentChangeService^ changeService )
   {
      // Registers an event handler for the ComponentChanged event.
      changeService->ComponentChanged += gcnew ComponentChangedEventHandler(
         this, &ComponentChangedEventHandlerExample::OnComponentChanged );
   }

private:
   void OnComponentChanged( Object^ sender, ComponentChangedEventArgs^ e )
   {
      // Displays changed component information on the console.
      Console::WriteLine( "Type of the component that has changed: " +
         e->Component->GetType()->FullName );
      Console::WriteLine( "Name of the member of the component that has changed: " +
         e->Member->Name );
      Console::WriteLine( "Old value of the member: " + e->OldValue );
      Console::WriteLine( "New value of the member: " + e->NewValue );
   }

public void LinkComponentChangedEvent(IComponentChangeService changeService)
{
    // Registers an event handler for the ComponentChanged event.
    changeService.add_ComponentChanged(new 
        ComponentChangedEventHandler(this.OnComponentChanged));
} //LinkComponentChangedEvent

private void OnComponentChanged(Object sender, ComponentChangedEventArgs e)
{
    // Displays changed component information on the console.
    Console.WriteLine("Type of the component that has changed: " 
        + e.get_Component().GetType().get_FullName());
    Console.WriteLine("Name of the member of the component "
        + "that has changed: " + e.get_Member().get_Name());
    Console.WriteLine("Old value of the member: " 
        + e.get_OldValue().ToString());
    Console.WriteLine("New value of the member: " 
        + e.get_NewValue().ToString());
} //OnComponentChanged

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

System.ComponentModel.Design-Namespace
ComponentChanged
ComponentChanging
ComponentChangedEventArgs-Klasse
IComponentChangeService

Freigeben über