ControlDesigner.InvokeTransactedChange Method (IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)
Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.
Assembly: System.Design (in System.Design.dll)
public static void InvokeTransactedChange( IComponent component, TransactedChangeCallback callback, Object context, string description, MemberDescriptor member )
- Type: System.ComponentModel.IComponent
The control associated with the control designer.
- Type: System.Web.UI.Design.TransactedChangeCallback
A TransactedChangeCallback object representing a function to call in the control designer as part of the transaction.
- Type: System.Object
An object that contains the argument for callback.
- Type: System.String
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.
The implementation of the InvokeTransactedChange method notifies the design host, which is determined by the Site property of component, 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 associated control throws a static Canceled exception field of a CheckoutException exception, the transaction is canceled without invoking callback.
For a code example, see InvokeTransactedChange(IComponent, TransactedChangeCallback, Object, String).
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)