IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Methode

  • Referenz

Definition

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

Teilt dem Komponentenänderungsdienst mit, dass eine bestimmte Komponente gerade geändert wird.

public:
 void OnComponentChanging(System::Object ^ component, System::ComponentModel::MemberDescriptor ^ member);
public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor member);
public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor? member);
abstract member OnComponentChanging : obj * System.ComponentModel.MemberDescriptor -> unit
Public Sub OnComponentChanging (component As Object, member As MemberDescriptor)

Parameter

component
Object

Die Komponente, die gerade geändert wird.

member
MemberDescriptor

Der Member, der gerade geändert wird. Der Wert ist null, wenn sich die Änderung nicht auf einen einzelnen Member bezieht.

Hinweise

Diese Methode löst das ComponentChanging -Ereignis aus.

Die meisten Designer, die im Windows SDK enthalten sind, sowie die Visual Studio-Entwurfszeitumgebung lösen dieses Ereignis in der Regel automatisch aus. Daher müssen Sie diese Methode in den meisten Fällen nicht explizit aufrufen. Die entsprechenden IComponentChangeService Ereignisse werden automatisch ausgelöst, wenn ein PropertyDescriptor zum Ändern eines Eigenschaftswerts verwendet wird oder Komponenten dem IDesignerHost Container hinzugefügt oder daraus entfernt werden.

Hinweise für Ausführende

Diese Methode löst eine Ausnahme aus, wenn die Eigenschaft nicht geändert werden kann. Dies ist nicht zum Überprüfen der Werte einer bestimmten Eigenschaft vorgesehen. Stattdessen soll eine globale Methode bereitgestellt werden, mit der verhindert wird, dass sich eine Komponente ändert. Wenn beispielsweise eine Designerdatei in die Quellcodeverwaltung eingecheckt wird, löst der Handler dieses Ereignisses in der Regel eine Ausnahme aus, wenn sich der Benutzer weigerte, die Datei auszuchecken.

Gilt für:

Weitere Informationen