ControlDesigner.InvokeTransactedChange Method (IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)
Assembly: System.Design (in system.design.dll)
public: static void InvokeTransactedChange ( IServiceProvider^ serviceProvider, IComponent^ component, TransactedChangeCallback^ callback, Object^ context, String^ description, MemberDescriptor^ member )
public static void InvokeTransactedChange ( IServiceProvider serviceProvider, IComponent component, TransactedChangeCallback callback, Object context, String description, MemberDescriptor member )
public static function InvokeTransactedChange ( serviceProvider : IServiceProvider, component : IComponent, callback : TransactedChangeCallback, context : Object, description : String, member : MemberDescriptor )
Parameters
- serviceProvider
An IServiceProvider representing the design host that provides control designer services for the associated control.
- component
The control associated with the control designer.
- callback
A TransactedChangeCallback representing a function to call in the control designer as part of the transaction.
- context
An object that contains the argument for callback.
- description
A description of the effect of allowing the transaction to complete, which is used by the design host to give the user an opportunity to cancel the transaction.
- member
A MemberDescriptor (typically either an EventDescriptor or a PropertyDescriptor) that describes the member of the associated control that is being invoked as part of the transaction.
The implementation of the InvokeTransactedChange method notifies the design host, which is represented by serviceProvider, that a change is occurring to the specified member (property or method) of the associated control and, if the change is not canceled by the design host, invokes the specified callback using the specified context as the argument, and then notifies the design host that the change has completed.
If the design host or the associated control throws a static Canceled exception field of a CheckoutException exception, the transaction is canceled without invoking callback.
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.