ComponentChangingEventArgs-Klasse

Artikel
08/20/2007

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

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

Syntax

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

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

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

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

ComVisibleAttribute(true) 
public final class ComponentChangingEventArgs extends EventArgs

Hinweise

ComponentChangingEventArgs stellt Daten über ein ComponentChanging-Ereignis bereit. Das ComponentChanging-Ereignis benachrichtigt IComponentChangeService und die registrierten Ereignishandler darüber, dass eine bestimmte Komponente des aktuellen Entwurfsdokuments geändert wird. Dieses Ereignis stellt eine annähernd uneingeschränkt verfügbare Methode bereit, mit der das Ändern einer Komponente verhindert werden kann.

Ein ComponentChanging-Ereignis wird vor der Änderung einer Komponente ausgelöst. Mithilfe dieses Ereignisses kann die Änderung von einem Designer abgebrochen werden. Komponenten-Designer lösen das ComponentChanging-Ereignis normalerweise automatisch aus. Wenn eine Eigenschaft nicht geändert werden kann, sollte die Methode, die das Ereignis behandelt, eine Ausnahme auslösen. Wenn z. B. eine Entwurfsdatei in die Quellcodeverwaltung eingecheckt wird, wird der Handler für dieses Ereignis i. d. R. eine Ausnahme auslösen, wenn der Benutzer die Datei nicht auscheckt.

Ein ComponentChangingEventArgs-Objekt stellt folgende Informationen zur Verfügung:

Eine Component-Eigenschaft, die die Komponente angibt, die geändert wird.
Eine Member-Eigenschaft, die den Member angibt, der geändert 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 ComponentChangingEventArgs veranschaulicht.

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

    ' The component that is about to change:       args.Component
    ' The member that is about to change:          args.Member

    Return args
End Function

// This example method creates a ComponentChangingEventArgs using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.  
public ComponentChangingEventArgs CreateComponentChangingEventArgs(object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new ComponentChangingEventArgs(component, member);

    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member

    return args;
}

public:
   // This example method creates a ComponentChangingEventArgs using the specified arguments.
   // Typically, this type of event args is created by a design mode subsystem.
   ComponentChangingEventArgs^ CreateComponentChangingEventArgs( Object^ component, MemberDescriptor^ member )
   {
      // The component that is about to change:       args.Component
      // The member that is about to change:          args.Member
      return gcnew ComponentChangingEventArgs( component,member );
   }

// This example method creates a ComponentChangingEventArgs
// using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
public ComponentChangingEventArgs CreateComponentChangingEventArgs(
    Object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new 
        ComponentChangingEventArgs(component, member);
    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member
    return args;
} //CreateComponentChangingEventArgs

Vererbungshierarchie

System.Object
System.EventArgs
System.ComponentModel.Design.ComponentChangingEventArgs

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

ComponentChangingEventArgs-Member
System.ComponentModel.Design-Namespace
ComponentChanging
ComponentChanged
ComponentChangingEventHandler
IComponentChangeService

Freigeben über