ComponentChangingEventArgs Klasse

  • Referenz

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComponentChangingEventArgs : EventArgs
type ComponentChangingEventArgs = class
    inherit EventArgs
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComponentChangingEventArgs = class
    inherit EventArgs
Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs
Vererbung
Object
EventArgs
ComponentChangingEventArgs
Attribute
ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird das Erstellen eines ComponentChangingEventArgs.

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 ComponentChanging Ereignis bereit. Das ComponentChanging Ereignis benachrichtigt die IComponentChangeService und registrierten Ereignishandler, dass eine bestimmte Komponente im aktuellen Entwurfsdokument geändert werden soll. Dieses Ereignis bietet eine weit 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 eine Möglichkeit für einen Designer, die Änderung abzubrechen. Komponentendesigner lösen das ComponentChanging Ereignis normalerweise 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 die Datei nicht auscheckt.

Eine ComponentChangingEventArgs stellt die folgenden Informationen bereit:

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

  • Eine Member Eigenschaft, die angibt, dass das Element 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)

Gilt für:

Siehe auch