ComponentChangingEventArgs Klasse

Definition

Namespace:

System.ComponentModel.Design

Assembly:

System.ComponentModel.TypeConverter.dll

Quelle:

ComponentChangingEventArgs.cs

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

public ref class ComponentChangingEventArgs sealed : EventArgs

public sealed class ComponentChangingEventArgs : EventArgs

type ComponentChangingEventArgs = class
    inherit EventArgs

Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

ComponentChangingEventArgs

Beispiele

Im folgenden Beispiel wird das Erstellen eines ComponentChangingEventArgsveranschaulicht.

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;
}

' 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

Hinweise

ComponentChangingEventArgs stellt Daten zu einem Ereignis bereit ComponentChanging . Das ComponentChanging -Ereignis benachrichtigt die IComponentChangeService registrierten Ereignishandler und darüber, dass eine bestimmte Komponente im aktuellen Entwurfsdokument geändert werden soll. Dieses Ereignis bietet eine allgemein zugängliche Methode, um zu verhindern, dass sich eine Komponente ändert.

Ein ComponentChanging Ereignis wird ausgelöst, bevor eine Komponente geändert wird. Dieses Ereignis bietet einem Designer die Möglichkeit, die Änderung abzubrechen. Komponentendesigner lösen das Ereignis in der ComponentChanging Regel automatisch aus. Wenn eine Eigenschaft nicht geändert werden kann, kann die Methode, die das Ereignis behandelt, eine Ausnahme auslösen. Wenn beispielsweise eine Designerdatei in die Quellcodeverwaltung eingecheckt wird, löst der Handler dieses Ereignisses in der Regel eine Ausnahme aus, wenn der Benutzer das Auschecken der Datei ablehnt.

Ein ComponentChangingEventArgs stellt die folgenden Informationen bereit:

• Eine Component Eigenschaft, die die Komponente angibt, die gerade geändert werden soll.

• Eine Member Eigenschaft, die das Element angibt, das gerade geändert werden soll.

Hinweise für Vererber

Ein Compilerfehler tritt auf, wenn diese Klasse als Basisklasse einer anderen Klasse angegeben wird.

Konstruktoren

ComponentChangingEventArgs(Object, MemberDescriptor)

Initialisiert eine neue Instanz der ComponentChangingEventArgs-Klasse.

Eigenschaften

Component	Ruft die zu ändernde Komponente ab bzw. die Komponente, die den übergeordneten Container des zu ändernden Members darstellt.
Member	Ruft den Member ab, der geändert wird.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• ComponentChanging
• ComponentChanged
• ComponentChangingEventHandler
• IComponentChangeService