不可分性

如果忽略該事務(wù)指令，則將對(duì)此頁(yè)禁用事務(wù)。

自動(dòng)事務(wù)和 XML Web services  [C#]

ASP.NET使用與Web窗體一致且相似的編程抽象模型為創(chuàng)建和公開(kāi)XML Web services 提供內(nèi)置支持。結(jié)果模型是可伸縮和可擴(kuò)展的,并接受 HTTP、XML、SOAP、WSDL 開(kāi)放式Internet以及其他標(biāo)準(zhǔn)。XML Web services 支持開(kāi)放式標(biāo)準(zhǔn)，因此任何客戶端或支持Internet的設(shè)備都可訪問(wèn)和使用XML Web services。

XML Web services 提供了在自動(dòng)事務(wù)范圍內(nèi)運(yùn)行代碼的選項(xiàng)。事務(wù)確保與資源管理器(如 SQL Server、MSMQ 服務(wù)器、Oracle 服務(wù)器和 SNA 服務(wù)器)的所有交互維護(hù)運(yùn)行可靠的分布式應(yīng)用程序所需的ACID屬性。

使用 WebMethod 特性的 TransactionOption 屬性聲明一個(gè)自動(dòng)事務(wù)。如果將 TransactionOption 屬性設(shè)置為 TransactionOption.RequiresNew，則每次 XML Web services 客戶端調(diào)用 XML Web services 方法時(shí)，都會(huì)開(kāi)始一個(gè)新事務(wù)。

下列代碼片斷顯示公開(kāi)一個(gè) XML Web services 方法（名為 DeleteAuthor）的服務(wù)。此 XML Web services 方法執(zhí)行一個(gè)自動(dòng)事務(wù)范圍內(nèi)的數(shù)據(jù)庫(kù)操作。

<%@ WebService Language="C#" Class="Orders" %>

<%@ assembly name="System.EnterpriseServices" %>

using System;

using System.Data;

using System.Data.SqlClient;

using System.Web.Services;

using System.Web.Util;

using System.EnterpriseServices;

public class Orders : WebService

 {

     [ WebMethod(TransactionOption=TransactionOption.RequiresNew)]

     public int DeleteAuthor(string lastName) 

     {

       String deleteCmd = "DELETE FROM authors2

          where au_lname='" + lastName + "'" ;

         SqlConnection sqlConn = new SqlConnection("user

          id=sa;database=pubs;server=myserver");

         SqlCommand myCommand = new SqlCommand(deleteCmd,sqlConn);

   // If a XML Web service method is participating in a transaction and an

   // exception occurs, ASP.NET automatically aborts the transaction.

   // Likewise, if no exception occurs, then the transaction is

   // automatically committed.

         myCommand.Connection.Open();

      return myCommand.ExecuteNonQuery();

     }

}

注意: 僅當(dāng)激活的XML Web services方法（從客戶端調(diào)用的方法）有事務(wù)元數(shù)據(jù)時(shí),事務(wù)才會(huì)開(kāi)始。如果激活的 XML Web services 方法未攜帶合適的事務(wù)元數(shù)據(jù)，則后繼的 XML Web services 方法可能既不參與現(xiàn)有事務(wù)也不開(kāi)始新事務(wù)。

自動(dòng)事務(wù)和.NET 框架類  [C#]

只要準(zhǔn)備了.NET 框架類參與自動(dòng)事務(wù)，此類的實(shí)例就可以參與自動(dòng)事務(wù)。類實(shí)例或?qū)ο笤L問(wèn)的每個(gè)資源都在事務(wù)中登記。例如，如果一個(gè)對(duì)象使用 ADO.NET 發(fā)送數(shù)據(jù)庫(kù)中某帳戶上的錢，此數(shù)據(jù)庫(kù)的資源管理器將確定該對(duì)象是否在事務(wù)中執(zhí)行。如果對(duì)象是在事務(wù)中執(zhí)行，則資源管理器自動(dòng)在事務(wù)中登記此數(shù)據(jù)庫(kù)。

使用下列過(guò)程準(zhǔn)備參與自動(dòng)事務(wù)的類：

1. 將 TransactionAttribute 應(yīng)用于此類。
2. 從 ServicedComponent 類派生此類。
3. 用強(qiáng)名稱為程序集簽名。

若要使用特性為程序集簽名，請(qǐng)使用 Sn.exe 實(shí)用工具創(chuàng)建一個(gè)密鑰對(duì)。

sn -k TestApp.snk

添加 AssemblyKeyFileAttribute 或 AssemblyKeyNameAttribute 程序集特性（它們指定包含密鑰對(duì)的文件的名稱），以使用強(qiáng)名稱為程序集簽名。

[assembly: AssemblyKeyFileAttribute("TestApp.snk")]

4. 向 COM+ 目錄注冊(cè)包含此類的程序集。

如果類的客戶端調(diào)用實(shí)例是由公共語(yǔ)言運(yùn)行庫(kù)管理的，則注冊(cè)將自動(dòng)執(zhí)行。但是，如果預(yù)期非托管調(diào)用方可能創(chuàng)建和調(diào)用類的實(shí)例，請(qǐng)使用 .NET 服務(wù)安裝工具 (Regsvcs.exe) 手動(dòng)執(zhí)行注冊(cè)。

下列示例顯示如何將 TransactionAttribute 應(yīng)用到從 ServicedComponent 類派生的類。

[Transaction(TransactionOption.Required)]

public class Bar(): ServicedComponent

{

 //. . .

}

應(yīng)用事務(wù)特性時(shí)，可以交替使用 Transaction、transaction、TransactionAttribute 和 transactionattribute。例如，可以使用 Transaction 或 transactionattribute 產(chǎn)生相同的結(jié)果。

下表列出并描述每個(gè)構(gòu)造函數(shù)變體。

[Transaction(TransactionOption.Disabled)]

[Transaction(TransactionOption.NotSupported)]

[Transaction(TransactionOption.Supported)]

[Transaction(TransactionOption.Required)]

[Transaction(TransactionOption.RequiresNew)]

示例類

下列代碼示例說(shuō)明自動(dòng)事務(wù)的若干元素。此例中，事務(wù)性類和調(diào)用此類的客戶端都由運(yùn)行庫(kù)管理。

// -----------------------------------------------------------------
// TestApp.cs
// Generate a Strong name: 
//    sn -k TestApp.snk
// Compile the code:
//    csc /target:exe /r:System.EnterpriseServices.dll TestApp.cs
// Run TestApp:
//    start TestApp.exe
// -----------------------------------------------------------------
using System;
using System.Runtime.CompilerServices;
using System.EnterpriseServices;
using System.Reflection;
 
//Registration details.
//COM+ application name as it appears in the COM+ catalog.
[assembly: ApplicationName("TestApp")]
//Strong name for assembly.
[assembly: AssemblyKeyFileAttribute("TestApp.snk")]
 
[Transaction(TransactionOption.Required)]
public class Account : ServicedComponent
{
 //Provides SetComplete behavior in the absence of exceptions.
 [AutoComplete]
 public void Debit(int amount)
 {
     // Do some database work. Any exception thrown here aborts the 
     // transaction; otherwise, transaction commits.
 }
}
 
public class client
{
 public static int Main() 
  {
    Account accountX = new Account();
    accountX.Debit(100);
    return 0;
 }
}
自動(dòng)事務(wù)中的投票  [C#]

.NET 框架類和 ASP.NET 頁(yè)可以通過(guò)投票來(lái)提交或中止它們的當(dāng)前事務(wù)。默認(rèn)情況下，如果代碼中沒(méi)有顯式投票，則默認(rèn)為贊成提交。但默認(rèn)提交可能會(huì)延長(zhǎng)為每個(gè)事務(wù)釋放昂貴資源所用的時(shí)間，從而可能降低應(yīng)用程序的性能。

顯式投票還允許類或頁(yè)在遇到嚴(yán)重錯(cuò)誤時(shí)中止事務(wù)。此外，可以通過(guò)在事務(wù)處理的早期捕獲致命錯(cuò)誤、結(jié)束事務(wù)、釋放資源等手段來(lái)提高應(yīng)用程序的性能。

使用自動(dòng)完成

System.EnterpriseServices.AutoCompleteAttribute 使參與事務(wù)的對(duì)象投票贊成在方法正常返回時(shí)完成事務(wù)。如果方法調(diào)用引發(fā)異常，則中止事務(wù)。只能將此特性應(yīng)用于從 ServicedComponent 類派生的類。

若要使用此功能，請(qǐng)?jiān)陬惙椒ㄇ安迦氪颂匦?。如果將此特性添加到接口方法，則公共語(yǔ)言運(yùn)行庫(kù)將忽略它。下列代碼片斷顯示此特性在事務(wù)識(shí)別類上的位置。

[Transaction(TransactionOption.Supported)]

public class Account : ServicedComponent {

    [AutoComplete]

    public void Debit(int amount) {

        // Do some database work. Any exception thrown here aborts the transaction; 

        // otherwise, transaction commits.

    }

}

使用SetAbort 和SetComplete

可以使用公開(kāi) SetComplete 或 SetAbort 方法的 System.EnterpriseServices.ContextUtil 類來(lái)顯式提交或中止事務(wù)。SetComplete 指示對(duì)象投票贊成提交其工作；SetAbort 指示對(duì)象遇到了問(wèn)題且投票贊成中止正在進(jìn)行的事務(wù)。直到事務(wù)的根對(duì)象停用，才提交或中止事務(wù)。此外，任何參與事務(wù)的對(duì)象中有一個(gè)中止投票，都將導(dǎo)致整個(gè)事務(wù)失敗。

下列代碼片斷顯示正在使用的 SetAbort 和 SetComplete 方法。

//Try to do something crucial to the transaction in progress.

if( !DoSomeWork() )

{

 //Something goes wrong.

 ContextUtil.SetAbort();

}

else

{

 //All goes well.

 ContextUtil.SetComplete();

}