ComponentChangingEventArgs Klasse

Definition

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

Beispiele

Das folgende Beispiel veranschaulicht 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 gerade 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 die Möglichkeit, dass ein Designer die Änderung abbricht. 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 ist, löst der Handler dieses Ereignisses in der Regel eine Ausnahme aus, wenn der Benutzer das Auschecken der Datei verweigert.

A 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

Wenn diese Klasse als Basisklasse einer anderen Klasse angegeben wird, tritt ein Compilerfehler auf.

Konstruktoren

Name Beschreibung
ComponentChangingEventArgs(Object, MemberDescriptor)

Initialisiert eine neue Instanz der ComponentChangingEventArgs-Klasse.

Eigenschaften

Name Beschreibung
Component

Ruft die Komponente ab, die gerade geändert werden soll, oder die Komponente, die der übergeordnete Container des Elements ist, das gerade geändert werden soll.
Member

Ruft das Mitglied ab, das gerade geändert werden soll.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen