SqlCeCommand.Transaction-Eigenschaft

Artikel
05/27/2011

Ruft die Transaktion ab, in der die SqlCeCommand-Klasse ausgeführt wird, oder legt diese fest.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
Public Property Transaction As SqlCeTransaction
    Get
    Set
'Usage
Dim instance As SqlCeCommand
Dim value As SqlCeTransaction

value = instance.Transaction

instance.Transaction = value

public SqlCeTransaction Transaction { get; set; }

public:
property SqlCeTransaction^ Transaction {
    SqlCeTransaction^ get ();
    void set (SqlCeTransaction^ value);
}

member Transaction : SqlCeTransaction with get, set

function get Transaction () : SqlCeTransaction
function set Transaction (value : SqlCeTransaction)

Eigenschaftswert

Typ: System.Data.SqlServerCe.SqlCeTransaction
Die SqlCeTransaction-Klasse. Der Standardwert ist nullein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Die Transaction-Eigenschaft kann nicht festgelegt werden, wenn diese bereits auf einen bestimmten Wert festgelegt ist und der Befehl gerade ausgeführt wird. Wenn Sie die Transaktionseigenschaft eines SqlCeTransaction-Objekts festlegen, das nicht mit derselben SqlCeConnection-Klasse wie das SqlCeCommand-Objekt verbunden ist, wird bei der nächsten Ausführung einer Anweisung eine Ausnahme ausgelöst.

Wenn die SqlCeCommand-Klasse ausgeführt wird und die SqlCeTransaction-Klasse auf nullein NULL-Verweis (Nothing in Visual Basic) festgelegt ist, wird der Befehl im Autocommit-Modus ausgeführt. Daher wird jede Anweisung in einer eigenen Transaktion ausgeführt.

Beispiele

Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
conn.Open()

' Start a local transaction
'
Dim tx As SqlCeTransaction = conn.BeginTransaction()

' By default, commands run in auto-commit mode; 
'
Dim cmd1 As SqlCeCommand = conn.CreateCommand()

' You may create multiple commands on the same connection
'
Dim cmd2 As SqlCeCommand = conn.CreateCommand()

' To enlist a command in a transaction, set the Transaction property
'
cmd1.Transaction = tx

Try
    cmd1.CommandText = "INSERT INTO Shippers ([Company Name]) VALUES ('Northwind Traders')"
    cmd1.ExecuteNonQuery()

    ' Auto-commited because cmd2 is not enlisted in a transaction
    '
    cmd2.CommandText = "INSERT INTO Employees ([Last Name], [First Name]) VALUES ('Decker', 'Barbara')"
    cmd2.ExecuteNonQuery()

    ' This will cause referential constraint violation
    '
    cmd1.CommandText = "DELETE FROM Products WHERE [Product ID] = 1"
    cmd1.ExecuteNonQuery()

    ' Commit the changes to disk if everything above succeeded
    '
    tx.Commit()
Catch
    tx.Rollback()
Finally
    conn.Close()
End Try

SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
conn.Open();

// Start a local transaction
//
SqlCeTransaction tx = conn.BeginTransaction();

// By default, commands run in auto-commit mode; 
//
SqlCeCommand cmd1 = conn.CreateCommand();

// You may create multiple commands on the same connection
//
SqlCeCommand cmd2 = conn.CreateCommand();

// To enlist a command in a transaction, set the Transaction property
//
cmd1.Transaction = tx;

try
{
    cmd1.CommandText = "INSERT INTO Shippers ([Company Name]) VALUES ('Northwind Traders')";
    cmd1.ExecuteNonQuery();

    // Auto-commited because cmd2 is not enlisted in a transaction
    //
    cmd2.CommandText = "INSERT INTO Employees ([Last Name], [First Name]) VALUES ('Decker', 'Barbara')";
    cmd2.ExecuteNonQuery();

    // This will cause referential constraint violation
    //
    cmd1.CommandText = "DELETE FROM Products WHERE [Product ID] = 1";
    cmd1.ExecuteNonQuery();

    // Commit the changes to disk if everything above succeeded
    //
    tx.Commit();
}
catch (Exception)
{
    tx.Rollback();
}
finally
{
    conn.Close();
}

Siehe auch

Verweis

SqlCeCommand Klasse

System.Data.SqlServerCe-Namespace

Freigeben über