事 务 处 理
不可分性
|
指令
|
说明
|
|
Disabled
|
指示 ASP.NET 将忽略事务上下文。这是默认的事务状态。
|
|
NotSupported
|
指示该页不在事务范围内运行。处理请求后，不管是否有活动事务，均在没有事务的情况下创建其对象上下文。
|
|
Supported
|
指示该页在现有事务的上下文中运行。如果没有事务，则该页在没有事务的情况下运行。
|
|
Required
|
该页在现有事务的上下文中运行。如果没有事务，则该页将启动一个事务。
|
|
RequiresNew
|
指示该页需要事务且为每个请求启动新事务。
|
如果忽略该事务指令，则将对此页禁用事务。
自动事务和 XML Web services [C#]
ASP.NET使用与Web窗体一致且相似的编程抽象模型为创建和公开XML Web services 提供内置支持。结果模型是可伸缩和可扩展的,并接受 HTTP、XML、SOAP、WSDL 开放式Internet以及其他标准。XML Web services 支持开放式标准，因此任何客户端或支持Internet的设备都可访问和使用XML Web services。
XML Web services 提供了在自动事务范围内运行代码的选项。事务确保与资源管理器(如 SQL Server、MSMQ 服务器、Oracle 服务器和 SNA 服务器)的所有交互维护运行可靠的分布式应用程序所需的ACID属性。
使用 WebMethod 特性的 TransactionOption 属性声明一个自动事务。如果将TransactionOption 属性设置为 TransactionOption.RequiresNew，则每次 XML Web services 客户端调用 XML Web services 方法时，都会开始一个新事务。
下列代码片断显示公开一个 XML Web services 方法（名为 DeleteAuthor）的服务。此 XML Web services 方法执行一个自动事务范围内的数据库操作。
<%@ 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();
}
}
注意: 仅当激活的XML Web services方法（从客户端调用的方法）有事务元数据时,事务才会开始。如果激活的 XML Web services 方法未携带合适的事务元数据，则后继的 XML Web services 方法可能既不参与现有事务也不开始新事务。
自动事务和.NET 框架类 [C#]
只要准备了.NET 框架类参与自动事务，此类的实例就可以参与自动事务。类实例或对象访问的每个资源都在事务中登记。例如，如果一个对象使用 ADO.NET 发送数据库中某帐户上的钱，此数据库的资源管理器将确定该对象是否在事务中执行。如果对象是在事务中执行，则资源管理器自动在事务中登记此数据库。
使用下列过程准备参与自动事务的类：
- 将 TransactionAttribute 应用于此类。
- 从 ServicedComponent 类派生此类。
- 用强名称为程序集签名。
若要使用特性为程序集签名，请使用 Sn.exe 实用工具创建一个密钥对。
sn -k TestApp.snk
添加 AssemblyKeyFileAttribute 或 AssemblyKeyNameAttribute 程序集特性（它们指定包含密钥对的文件的名称），以使用强名称为程序集签名。
[assembly: AssemblyKeyFileAttribute("TestApp.snk")]
- 向 COM+ 目录注册包含此类的程序集。
如果类的客户端调用实例是由公共语言运行库管理的，则注册将自动执行。但是，如果预期非托管调用方可能创建和调用类的实例，请使用 .NET 服务安装工具 (Regsvcs.exe) 手动执行注册。
下列示例显示如何将 TransactionAttribute 应用到从 ServicedComponent 类派生的类。
[Transaction(TransactionOption.Required)]
public class Bar(): ServicedComponent
{
//. . .
}
应用事务特性时，可以交替使用 Transaction、transaction、TransactionAttribute 和transactionattribute。例如，可以使用 Transaction 或 transactionattribute 产生相同的结果。
下表列出并描述每个构造函数变体。
|
特性值 |
说明 |
|
Disabled |
消除自动事务对对象的控制。应用此特性值的对象可以直接将分布式事务处理协调器 (DTC) 用于事务性支持。 [Transaction(TransactionOption.Disabled)]
|
|
NotSupported |
指示对象不在事务范围内运行。处理请求后，不管是否有活动事务，均在没有事务的情况下创建其对象上下文。 [Transaction(TransactionOption.NotSupported)]
|
|
Supported |
指示如果有事务，则对象在现有事务的上下文中运行。如果没有事务，则对象在没有事务的情况下运行。 [Transaction(TransactionOption.Supported)]
|
|
Required （默认值） |
指示对象需要事务。如果有事务，则对象在现有事务范围中运行。如果没有事务，则对象启动一个事务。 [Transaction(TransactionOption.Required)]
|
|
RequiresNew |
指示对象需要事务且为每个请求启动新事务。 [Transaction(TransactionOption.RequiresNew)]
|
示例类
下列代码示例说明自动事务的若干元素。此例中，事务性类和调用此类的客户端都由运行库管理。
自动事务中的投票 [C#]
.NET 框架类和 ASP.NET 页可以通过投票来提交或中止它们的当前事务。默认情况下，如果代码中没有显式投票，则默认为赞成提交。但默认提交可能会延长为每个事务释放昂贵资源所用的时间，从而可能降低应用程序的性能。
显式投票还允许类或页在遇到严重错误时中止事务。此外，可以通过在事务处理的早期捕获致命错误、结束事务、释放资源等手段来提高应用程序的性能。
使用自动完成
System.EnterpriseServices.AutoCompleteAttribute 使参与事务的对象投票赞成在方法正常返回时完成事务。如果方法调用引发异常，则中止事务。只能将此特性应用于从 ServicedComponent 类派生的类。
若要使用此功能，请在类方法前插入此特性。如果将此特性添加到接口方法，则公共语言运行库将忽略它。下列代码片断显示此特性在事务识别类上的位置。
[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
可以使用公开 SetComplete 或 SetAbort 方法的 System.EnterpriseServices.ContextUtil 类来显式提交或中止事务。SetComplete 指示对象投票赞成提交其工作；SetAbort 指示对象遇到了问题且投票赞成中止正在进行的事务。直到事务的根对象停用，才提交或中止事务。此外，任何参与事务的对象中有一个中止投票，都将导致整个事务失败。
下列代码片断显示正在使用的 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();
}