IComponentChangeService.OnComponentChanging-Methode

Artikel
08/20/2007

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

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

Syntax

'Declaration
Sub OnComponentChanging ( _
    component As Object, _
    member As MemberDescriptor _
)
'Usage
Dim instance As IComponentChangeService
Dim component As Object
Dim member As MemberDescriptor

instance.OnComponentChanging(component, member)

void OnComponentChanging (
    Object component,
    MemberDescriptor member
)

void OnComponentChanging (
    Object^ component, 
    MemberDescriptor^ member
)

void OnComponentChanging (
    Object component, 
    MemberDescriptor member
)

function OnComponentChanging (
    component : Object, 
    member : MemberDescriptor
)

Parameter

component
Die Komponente, die gerade geändert wird.

member
Der Member, der gerade geändert wird. Der Wert ist NULL (Nothing in Visual Basic), wenn sich die Änderung nicht auf einen einzelnen Member bezieht.

Hinweise

Diese Methode löst das ComponentChanging-Ereignis aus.

Die meisten mit dem .NET Framework SDK gelieferten Designer sowie die Visual Studio .NET-Entwurfszeitumgebung lösen dieses Ereignis i. d. R. automatisch aus, sodass Sie diese Methode in den meisten Fällen nicht explizit aufrufen müssen. Die entsprechenden IComponentChangeService-Ereignisse werden automatisch ausgelöst, wenn mit einem PropertyDescriptor ein Eigenschaftenwert geändert wird oder Komponenten einem IDesignerHost-Container hinzugefügt oder aus ihm entfernt werden.

Hinweise für Implementierer Diese Methode löst eine Ausnahme aus, wenn die Eigenschaft nicht geändert werden kann. Damit findet jedoch keine Validierung für die Werte einer bestimmten Eigenschaft statt. Diese Methode ist stattdessen als globale Methode ausgelegt, mit der Änderungen einer Komponente verhindert werden können. Wenn z. B. eine Entwurfsdatei in die Quellcodeverwaltung eingecheckt wird, wird der Handler dieses Ereignisses i. d. R. eine Ausnahme auslösen, wenn der Benutzer die Datei nicht auscheckt.

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

IComponentChangeService-Schnittstelle
IComponentChangeService-Member
System.ComponentModel.Design-Namespace
MemberDescriptor-Klasse

Freigeben über