如何: 使用 ServicedComponent Visual C#.NET 中執行.NET 提供廠商的分散式的交易

文章翻譯 文章翻譯
文章編號: 316247 - 檢視此文章適用的產品。
全部展開 | 全部摺疊

在此頁中

結論

本文將逐步告訴您,如何藉由使用.NET 提供者具有 ServicedComponent 類別執行分散式的交易。雖然本文使用 SqlClient.NET 提供者對 Microsoft SQL Server 伺服器,也可以使用 ODBC 或 OLE DB.NET Managed 提供者。

需求

下列清單列出建議的硬體、 軟體、 網路基礎結構及所需的 Service Pack:
  • Microsoft Windows 2000 專業版,Microsoft Windows 2000 Server Microsoft Windows 2000 進階的伺服器
  • Microsoft Visual Studio.NET
  • Microsoft SQL Server 7.0 或 Microsoft SQL Server 2000

概觀

如果您準備要執行這項操作類別,.NET Framework 類別的執行個體可以參與自動交易。每個類別執行個體或物件存取的資源登記在交易中。比方說如果物件會使用 ADO.NET 來在資料庫中的帳戶張貼金錢,資料庫的資源管理員會決定物件是否會在交易中執行。如果物件應該在交易中執行,資源管理員會自動登記在交易中的資料庫。

使用下列程序來準備類別以參與自動交易:
  1. TransactionAttribute 類別套用到您的類別,以指定元件要求自動交易類型。

    交易類型必須是 TransactionOption 列舉型別的成員。
  2. ServicedComponent 類別衍生您的類別。ServicedComponent 是使用 COM + 服務的所有類別的基底類別。
  3. 簽署使用強式名稱組件,請確定組件包含唯一的金鑰組。
  4. 註冊組件,其中包含您的類別與 COM + 目錄。

    注意: 如果用戶端會呼叫您類別的執行個體由通用語言執行階段管理,為您執行註冊。這個步驟是必要的只有不受管理的呼叫端會建立,且會呼叫您類別的執行個體。使用 「.NET 服務安裝工具 (Regsvcs.exe) 手動註冊組件 」。
更多有關如何簽署使用強式名稱組件請參閱 Microsoft.NET Framework 開發人員手冊 》 中下列的主題:
使用強式名稱組件簽署
http://msdn.microsoft.com/en-us/library/xc31ft41.aspx
如需有關此程序的詳細資訊,請參閱下列主題的 Microsoft.NET Framework 開發人員手冊 》]:
自動交易和.NET Framework 類別
http://msdn.microsoft.com/en-us/library/ms123400.aspx

建立專案

  1. 請依照下列步驟執行在 Visual C#.NET 中建立新的主控台應用程式專案:
    1. 啟動 Visual Studio.NET。
    2. 在 [檔案] 功能表上指向 [新增],然後按一下 [專案]。
    3. 在 [新增專案] 對話方塊按一下 [專案類型] 下的 [Visual C# 專案範本,] 下方按一下 [主控台應用程式 然後再按一下 [確定]。
    4. 在 [方案總管] 中重新命名為 DistributedTransaction.cs 的 Class1.cs 檔案。
  2. 刪除 DistributedTransaction.cs 檔案中的所有程式碼。
  3. 在 [專案] 功能表上按一下 [加入參考],並再將下列參考:
    • System.EnterpriseServices
    • System.Data.dll

  4. AssemblyInfo.cs] 檔案中註解下列幾行程式碼:
    [assembly: AssemblyKeyFile("")]
    [assembly: AssemblyKeyName("")]
    					
  5. 將下列程式碼加入至 DistributedTransaction.cs 檔:
    using System;
    using System.Data.SqlClient;
    using System.EnterpriseServices;
    using System.Runtime.CompilerServices;
    using System.Reflection;
    
    [assembly: ApplicationName("DistributedTransaction")]
    [assembly: AssemblyKeyFileAttribute("..\..\DistributedTransaction.snk")]
    
    
    namespace DistributedTransaction
    {
       /// <summary>
       /// Summary description for Class1.
       /// </summary>
       class Class1
       {
          /// <summary>
          /// The main entry point for the application.
          /// </summary>
          [STAThread]
          static void Main(string[] args)
          {
             try
             {
                DistributedTran myDistributedTran = new DistributedTran();
                myDistributedTran.TestDistributedTransaction();
             }
             catch (System.Data.SqlClient.SqlException e)
             {
                System.Console.WriteLine("Transaction Aborted: Error returned: " + e.Message);
             }         
          }
       }
       /// <summary>
       /// Summary description for TestApp.
       /// </summary>
       [Transaction(TransactionOption.Required)]
       public class DistributedTran: ServicedComponent 
       {
          public DistributedTran()
          {
          }
          [AutoComplete]
          public string TestDistributedTransaction()
          {
             // The following Insert statement goes to the first server.
             // This Insert statement does not produce any errors. 
             String insertCmdSql = "Insert Into TestTransaction (Col1, Col2) Values (1,'Sql Test')";
    
             // The following Delete statement goes to the second server.
             // Because the table does not exist, this code throws an exception.
             String exceptionCausingCmdSQL = "Delete from NonExistentTable";
                         
             // The following connection strings create instances of two SqlConnection objects
             // to connect to two different SQL Server servers in your environment.
             // Modify the connection strings as necessary for your environment.
             SqlConnection SqlConn1 = new SqlConnection("Server=Server_Name;uid=User_Id;database=DatabaseName;pwd=Password");
             SqlConnection SqlConn2 = new SqlConnection("Server=Server_Name;uid=User_Id;database=DatabaseName;pwd=Password");
    
             try
             {
                SqlCommand insertCmd = new SqlCommand(insertCmdSql,SqlConn1);
                SqlCommand exceptionCausingCmd = new SqlCommand(exceptionCausingCmdSQL,SqlConn2);
       
                // This command runs properly.
                insertCmd.Connection.Open();
                insertCmd.ExecuteNonQuery();
    
    
                // This command results in an exception, which automatically rolls back
                // the first command (the insertCmd command).
                exceptionCausingCmd.Connection.Open();
                int cmdResult = exceptionCausingCmd.ExecuteNonQuery();
                
                SqlConn1.Close();
                SqlConn2.Close();
    
                Console.WriteLine("Hello");
                
             }
             catch (System.Data.SqlClient.SqlException ex)
             {
                // After you catch the exception in this function, throw it. 
                // The service component receives this exception and 
                // aborts the transaction. The service component then
                // throws the same exception, and the calling function
                // receives the error message.
                Console.WriteLine (ex.Message);
                throw (ex);
             }
             finally 
             {
                // Close the connection.
                if (SqlConn1.State.ToString() == "Open")
                   SqlConn1.Close();
    
                if (SqlConn2.State.ToString() == "Open")
                   SqlConn2.Close();
             }
    
             return "Success";
           
          }
    
       }
    }
    					
  6. 在 [檔案] 功能表上按一下 [全部儲存]。
  7. 按一下 [開始],指向 [程式集]、 指向 [Microsoft Visual Studio.NET]、 指向 Visual Studio.NET 工具,然後再按一下 [Visual Studio.NET 命令提示字元]。
  8. 開啟您的專案所在的資料夾,然後再執行下列命令以使用強式名稱組件簽署:
    sn k DistributedTransaction.snk
  9. 建置您的應用程式。
  10. 在第一個 SQL Server 伺服器中建立下列表格:
    if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[TestTransaction]') and OBJECTPROPERTY(id, N'IsUserTable') = 1)
    drop table [dbo].[TestTransaction]
    GO
    
    CREATE TABLE [dbo].[TestTransaction] (
    	[Col1] [int] NULL ,
    	[Col2] [varchar] (100) NULL 
    ) ON [PRIMARY]
    GO 
    					
  11. 執行您的應用程式。請注意您會收到下列錯誤訊息 (這是預期的行為):
    交易已中止: 傳回錯誤: 無效的物件名稱 'NonExistentTable'。
  12. 開啟 SQL Server 查詢分析、 加入下列程式碼,然後按 F5 以執行查詢:
    USE NORTHWIND;
    SELECT * FROM TestTransaction WHERE Col1=1 AND Col2='Sql Test'
    						
    注意交易已中止,因為查詢不傳回任何資料列。
  13. 在您的 Visual C# 專案中找出下列程式碼:
    String exceptionCausingCmdSQL = "Delete from NonExistentTable";
    						
    並使用有效的查詢並不會使交易中止取代 SQL 陳述式。例如:
    String exceptionCausingCmdSQL = "Select @@Identity from customers";
    					
  14. 請按 F5 編譯並執行應用程式一次。
  15. 再次從步驟 12 Query Analyzer 中執行命令。請注意交易能夠順利完成,所以查詢會傳回資料列。
注意
  • 本範例並不會執行錯誤處理。
  • 所有用戶端和伺服器上必須執行 SQL Server,而且 Microsoft 分散式交易協調器 (MS DTC)。

?考

如需詳細資訊按一下面的文件編號,檢視 「 Microsoft 知識庫 」 中的發行項:
306296如何: 建立服務的.NET 元件,在 Visual C#.NET 中使用交易

屬性

文章編號: 316247 - 上次校閱: 2003年9月4日 - 版次: 3.3
這篇文章中的資訊適用於:
  • Microsoft ADO.NET 1.0
  • Microsoft ADO.NET 1.1
  • Microsoft Visual C# .NET 2002 Standard Edition
  • Microsoft Visual C# .NET 2003 標準版
  • Microsoft Enterprise Services (included with the .NET Framework) 1.0
  • Microsoft Enterprise Services (included with the .NET Framework 1.1)
關鍵字:?
kbmt kbcompiler kbhowtomaster kbsqlclient kbsystemdata KB316247 KbMtzh
機器翻譯
重要:本文是以 Microsoft 機器翻譯軟體翻譯而成,而非使用人工翻譯而成。Microsoft 同時提供使用者人工翻譯及機器翻譯兩個版本的文章,讓使用者可以依其使用語言使用知識庫中的所有文章。但是,機器翻譯的文章可能不盡完美。這些文章中也可能出現拼字、語意或文法上的錯誤,就像外國人在使用本國語言時可能發生的錯誤。Microsoft 不為內容的翻譯錯誤或客戶對該內容的使用所產生的任何錯誤或損害負責。Microsoft也同時將不斷地就機器翻譯軟體進行更新。
按一下這裡查看此文章的英文版本:316247
Microsoft及(或)其供應商不就任何在本伺服器上發表的文字資料及其相關圖表資訊的恰當性作任何承諾。所有文字資料及其相關圖表均以「現狀」供應,不負任何擔保責任。Microsoft及(或)其供應商謹此聲明,不負任何對與此資訊有關之擔保責任,包括關於適售性、適用於某一特定用途、權利或不侵權的明示或默示擔保責任。Microsoft及(或)其供應商無論如何不對因或與使用本伺服器上資訊或與資訊的實行有關而引起的契約、過失或其他侵權行為之訴訟中的特別的、間接的、衍生性的損害或任何因使用而喪失所導致的之損害、資料或利潤負任何責任。

提供意見

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com