ComponentChangedEventArgs-Klasse

Artikel
08/20/2007

Stellt Daten für das ComponentChanged-Ereignis bereit. Diese Klasse kann nicht vererbt werden.

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public NotInheritable Class ComponentChangedEventArgs
    Inherits EventArgs
'Usage
Dim instance As ComponentChangedEventArgs

[ComVisibleAttribute(true)] 
public sealed class ComponentChangedEventArgs : EventArgs

[ComVisibleAttribute(true)] 
public ref class ComponentChangedEventArgs sealed : public EventArgs

/** @attribute ComVisibleAttribute(true) */ 
public final class ComponentChangedEventArgs extends EventArgs

ComVisibleAttribute(true) 
public final class ComponentChangedEventArgs extends EventArgs

Hinweise

ComponentChangedEventArgs stellt Daten für ein ComponentChanged-Ereignis bereit. Das ComponentChanged-Ereignis benachrichtigt IComponentChangeService und die registrierten Ereignishandler darüber, dass eine bestimmte Komponente im gegenwärtig aktiven Dokument geändert wurde.

Ein ComponentChangedEventArgs stellt folgende Informationen zur Verfügung:

Eine Component-Eigenschaft, die die geänderte Komponente angibt.
Eine Member-Eigenschaft, die den geänderten Member angibt.
Eine NewValue-Eigenschaft, die den neuen Wert des Members angibt.
Eine OldValue-Eigenschaft, die den alten Wert des Members angibt.

Komponenten-Designer lösen das ComponentChanged-Ereignis i. d. R. automatisch aus, wenn Komponenten hinzugefügt, entfernt oder geändert werden. Da Änderungen beim Laden oder Entladen von Formularen erwartet werden, wird bei diesen Vorgängen kein ComponentChanged-Ereignis ausgelöst. Ein Komponenten-Designer kann das ComponentChanged-Ereignis auch nach dem Ändern einer Komponenteneigenschaft auslösen. So ist sichergestellt, dass im Eigenschaftenfenster der aktualisierte Wert der Eigenschaft angezeigt wird.

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.

Hinweise für Erben Ein Compilerfehler tritt auf, wenn diese Klasse als Basisklasse einer anderen Klasse angegeben wird.

Beispiel

Im folgenden Beispiel wird die Erstellung von ComponentChangedEventArgs veranschaulicht.

' This example method creates a ComponentChangedEventArgs using the specified arguments.
' Typically, this type of event args is created by a design mode subsystem.            
Public Function CreateComponentChangedEventArgs(ByVal component As Object, ByVal member As MemberDescriptor, ByVal oldValue As Object, ByVal newValue As Object) As ComponentChangedEventArgs
    ' Creates a component changed event args with the specified arguments.
    Dim args As New ComponentChangedEventArgs(component, member, oldValue, newValue)

    ' The component that has changed:              args.Component
    ' The member of the component that changed:    args.Member
    ' The old value of the member:                 args.oldValue
    ' The new value of the member:                 args.newValue
    Return args
End Function

// This example method creates a ComponentChangedEventArgs using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.            
public ComponentChangedEventArgs CreateComponentChangedEventArgs(object component, MemberDescriptor member, object oldValue, object newValue)
{            
    // Creates a component changed event args with the specified arguments.
    ComponentChangedEventArgs args = new ComponentChangedEventArgs(component, member, oldValue, newValue);

    // The component that has changed:              args.Component
    // The member of the component that changed:    args.Member
    // The old value of the member:                 args.oldValue
    // The new value of the member:                 args.newValue

    return args;            
}

public:
   // This example method creates a ComponentChangedEventArgs using the specified arguments.
   // Typically, this type of event args is created by a design mode subsystem.
   ComponentChangedEventArgs^ CreateComponentChangedEventArgs( Object^ component, MemberDescriptor^ member, Object^ oldValue, Object^ newValue )
   {
      // Creates a component changed event args with the specified arguments.
      ComponentChangedEventArgs^ args = gcnew ComponentChangedEventArgs( component, member, oldValue, newValue );
      
      // The component that has changed:              args->Component
      // The member of the component that changed:    args->Member
      // The old value of the member:                 args->oldValue
      // The new value of the member:                 args->newValue
      return args;
   }

// This example method creates a ComponentChangedEventArgs using 
// the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.            
public ComponentChangedEventArgs CreateComponentChangedEventArgs(
    Object component, MemberDescriptor member, Object oldValue, 
    Object newValue)
{
    // Creates a component changed event args with the specified arguments.
    ComponentChangedEventArgs args = new ComponentChangedEventArgs(component,
        member, oldValue, newValue);
    // The component that has changed:              args.Component
    // The member of the component that changed:    args.Member
    // The old value of the member:                 args.oldValue
    // The new value of the member:                 args.newValue
    return args;
} //CreateComponentChangedEventArgs

Vererbungshierarchie

System.Object
System.EventArgs
System.ComponentModel.Design.ComponentChangedEventArgs

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

ComponentChangedEventArgs-Member
System.ComponentModel.Design-Namespace
ComponentChanged
ComponentChanging
ComponentChangedEventHandler
IComponentChangeService

Freigeben über