TransactionManager.BeginTransaction Method (String, Boolean, TransactionContext)
Creates a new transaction object with a given name and returns a reference to it
Namespace: Microsoft.VisualStudio.Modeling
Assembly: Microsoft.VisualStudio.Modeling.Sdk.10.0 (in Microsoft.VisualStudio.Modeling.Sdk.10.0.dll)
Syntax
'Declaration
Public Function BeginTransaction ( _
name As String, _
isSerializing As Boolean, _
context As TransactionContext _
) As Transaction
public Transaction BeginTransaction(
string name,
bool isSerializing,
TransactionContext context
)
public:
Transaction^ BeginTransaction(
String^ name,
bool isSerializing,
TransactionContext^ context
)
member BeginTransaction :
name:string *
isSerializing:bool *
context:TransactionContext -> Transaction
public function BeginTransaction(
name : String,
isSerializing : boolean,
context : TransactionContext
) : Transaction
Parameters
- name
Type: System.String
The transaction name.
- isSerializing
Type: System.Boolean
Determines the value of transaction.IsSerializing. true indicates that the model is being read from file.
- context
Type: Microsoft.VisualStudio.Modeling.TransactionContext
A transaction context object to make available during the transaction.
Return Value
Type: Microsoft.VisualStudio.Modeling.Transaction
A Transaction object.
Remarks
Use this version if you have written rules and event handlers that use information passed in a transaction context object. Because rules are called in an arbitrary order at the end of a transaction, it is not possible to pass information to or between them directly. The transaction context is a dictionary in which any kind of information can be passed.
Examples
// In a rule:
UsefulInfo info = this.Store.TransactionManager.CurrentTransaction
.TopLevelTransaction.Context.ContextInfo["akey"] as UsefulInfo;
.NET Framework Security
- 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.