IComponentChangeService.OnComponentChanged-Methode

Artikel
08/20/2007

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

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

Syntax

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

instance.OnComponentChanged(component, member, oldValue, newValue)

void OnComponentChanged (
    Object component,
    MemberDescriptor member,
    Object oldValue,
    Object newValue
)

void OnComponentChanged (
    Object^ component, 
    MemberDescriptor^ member, 
    Object^ oldValue, 
    Object^ newValue
)

void OnComponentChanged (
    Object component, 
    MemberDescriptor member, 
    Object oldValue, 
    Object newValue
)

function OnComponentChanged (
    component : Object, 
    member : MemberDescriptor, 
    oldValue : Object, 
    newValue : Object
)

Parameter

component
Die Komponente, die geändert wurde.

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

oldValue
Der alte Wert des Members. Dieser ist nur gültig, wenn der Member nicht NULL (Nothing in Visual Basic) ist.

newValue
Der neue Wert des Members. Dieser ist nur gültig, wenn der Member nicht NULL (Nothing in Visual Basic) ist.

Hinweise

Diese Methode löst das ComponentChanged-Ereignis aus.

Die meisten mit dem .NET Framework SDK gelieferten Designer sowie die Visual Studio .NET-Entwurfszeitumgebung lösen dieses Ereignis i. d. R. aus, wenn eine Komponente in einem Projekt geändert wird, 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.

Vor dem Aufruf von OnComponentChanged sollten Sie OnComponentChanging aufrufen, um anzugeben, dass eine Komponente gerade geändert wird, und dann die Änderung durchführen. Rufen Sie dann OnComponentChanged auf, um das ComponentChanged-Ereignis auszulösen.

Hinweise für Implementierer Dieses Ereignis ermöglicht Implementierern das möglicherweise erforderliche Nachbearbeiten nach der Änderung einer Eigenschaft. Ein Designer aktualisiert z. B. normalerweise den Quellcode, der die Eigenschaft auf den neuen Wert festlegt.

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