SqlTransaction.Save メソッド

セーブ ポイントの名前を指定して、トランザクション内にセーブ ポイントを作成します。セーブ ポイントは、トランザクションを部分的にロールバックするために使用できます。

Public Sub Save( _
   ByVal savePointName As String _)
[C#]
public void Save(stringsavePointName);
[C++]
public: void Save(String* savePointName);
[JScript]
public function Save(
   savePointName : String);

パラメータ

• savePointName
  セーブ ポイントの名前。

例外

例外の種類	条件
Exception	トランザクションのコミット中にエラーが発生しました。
InvalidOperationException	トランザクションは、既にコミットまたはロールバックされています。 または 接続が切断されています。

解説

Save メソッドは、Transact-SQL SAVE TRANSACTION ステートメントと等価です。詳細については、SQL Server Books Online を参照してください。

savePoint パラメータには、 BeginTransaction メソッドの一部の実装が備える transactionName パラメータと同じ値を使用できます。

セーブ ポイントを使用すると、トランザクションを部分的にロールバックできます。セーブ ポイントは Save メソッドを使用して作成します。セーブ ポイントを作成した後で Rollback メソッドを呼び出すと、トランザクションの開始時点ではなく、セーブ ポイントまでがロールバックされます。

セーブ ポイントは、エラーが発生する可能性が低い場合に便利です。エラーの発生頻度が低い場合は、更新を行う前にその更新が有効かどうかを確認するテストをトランザクションごとに行うよりも、トランザクションの一部をロールバックするようにセーブ ポイントを使用する方が効率的です。更新とロールバックは負荷の高い操作です。そのため、エラーが発生する可能性が低く、更新の有効性を事前にチェックする負担が比較的大きい場合だけ、セーブ ポイントは有効です。

使用例

[Visual Basic, C#, C++] SqlConnection および SqlTransaction を作成する例を次に示します。この例では、 BeginTransaction 、 Save 、 Commit 、 Rollback の各メソッドの使い方も示します。

 
Public Sub RunSqlTransaction(myConnString As String)
    Dim myConnection As New SqlConnection(myConnString)
    myConnection.Open()
    
    Dim myCommand As New SqlCommand()
    Dim myTrans As SqlTransaction
    
    ' Start a local transaction
    myTrans = myConnection.BeginTransaction()
    ' Assign transaction object for a pending local transaction
    myCommand.Connection = myConnection
    myCommand.Transaction = myTrans
    
    Try
        myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
        myCommand.ExecuteNonQuery()
        myTrans.Save("SampleTransaction")
        myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
        myCommand.ExecuteNonQuery()
        myTrans.Commit()
        Console.WriteLine("Both records are written to database.")
    Catch e As Exception
      Try
        myTrans.Rollback("SampleTransaction")
      Catch ex As SqlException
        If Not myTrans.Connection Is Nothing Then
          Console.WriteLine("An exception of type " & ex.GetType().ToString() & _
                            " was encountered while attempting to roll back the transaction.")
        End If
      End Try
    
      Console.WriteLine("An exception of type " & e.GetType().ToString() & _
                      "was encountered while inserting the data.")
      Console.WriteLine("Neither record was written to database.")
    Finally
      myConnection.Close()
    End Try
End Sub 'RunSqlTransaction

[C#] 
public void RunSqlTransaction(string myConnString)
 {
    SqlConnection myConnection = new SqlConnection(myConnString);
    myConnection.Open();

    SqlCommand myCommand = new SqlCommand();
    SqlTransaction myTrans;

    // Start a local transaction
    myTrans = myConnection.BeginTransaction();
    // Assign transaction object for a pending local transaction
    myCommand.Connection = myConnection;
    myCommand.Transaction = myTrans;

    try
    {
      myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
      myCommand.ExecuteNonQuery();
      myTrans.Save("SampleTransaction");
      myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
      myCommand.ExecuteNonQuery();
      myTrans.Commit();
      Console.WriteLine("Both records are written to database.");
    }
    catch(Exception e)
    {
      try
      {
        myTrans.Rollback("SampleTransaction");
      }
      catch (SqlException ex)
      {
        if (myTrans.Connection != null)
        {
          Console.WriteLine("An exception of type " + ex.GetType() +
                            " was encountered while attempting to roll back the transaction.");
        }
      }
    
      Console.WriteLine("An exception of type " + e.GetType() +
                        " was encountered while inserting the data.");
      Console.WriteLine("Neither record was written to database.");
    }
    finally 
    {
      myConnection.Close();
    }
}

[C++] 
public:
void RunSqlTransaction(String* myConnString)
 {
    SqlConnection* myConnection = new SqlConnection(myConnString);
    myConnection->Open();

    SqlCommand* myCommand = new SqlCommand();
    SqlTransaction* myTrans;

    // Start a local transaction
    myTrans = myConnection->BeginTransaction();
    // Assign transaction object for a pending local transaction
    myCommand->Connection = myConnection;
    myCommand->Transaction = myTrans;

    try
    {
      myCommand->CommandText = S"Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
      myCommand->ExecuteNonQuery();
      myTrans->Save(S"SampleTransaction");
      myCommand->CommandText = S"Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
      myCommand->ExecuteNonQuery();
      myTrans->Commit();
      Console::WriteLine(S"Both records are written to database.");
    }
    catch(Exception* e)
    {
      try
      {
        myTrans->Rollback(S"SampleTransaction");
      }
      catch (SqlException* ex)
      {
        if (myTrans->Connection != 0)
        {
          Console::WriteLine(S"An exception of type {0} was encountered while attempting to roll back the transaction.", ex->GetType());
        }
      }
    
      Console::WriteLine(S"An exception of type {0} was encountered while inserting the data.", e->GetType());
      Console::WriteLine(S"Neither record was written to database.");
    }
    __finally 
    {
      myConnection->Close();
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlTransaction クラス | SqlTransaction メンバ | System.Data.SqlClient 名前空間 | Commit | Rollback | BeginTransaction