This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

TransactionScope.Complete أسلوب

Visual Studio 2010

يشير إلى أن الجميع العمليات التي تتم في نطاق مكتمل بنجاح.

مساحة الاسم:  System.Transactions
التجميع:  System.Transactions (في System.Transactions.dll)

public void Complete()

استثناء:شرط
InvalidOperationException

وهذا أسلوب لقد تم استدعاء مرة واحدة.

عند satهوfied يتم مكتمل الجميع العمليات التي تتم في نطاق بنجاح، يجب أن تقوم باستدعاء th هو الأسلوب مرة واحدة فقط لإعلام إدارة المعاملات هذه التي الحالة عبر الجميع موارد هو قد التزمت consهوtent، وعملية. هو ممارسة جيدة جداً لوضع المكالمة كالعبارة الأخيرة في usingحظر.

لمزيد من المعلومات حول كيف يتم ترتيب هو أسلوب هو استخدامه، راجع Implementing An Implicit Transaction Using Transaction Scopeموضوع.

فشل إلى استدعاء هذا الأسلوب إحباط عملية، لأن إدارة المعاملات يفسر هذا كفشل النظام أو استثناءات طرح ضمن نطاق عملية. ومع ذلك، يجب أيضا ملاحظة أن استدعاء هذا أسلوب لا يضمن التزام المعاملات. تعتبر هذه طريقة لإعلام إدارة المعاملات للحالة الخاصة بك فقط. بعد استدعاء هذا الأسلوب، يمكن الوصول عملية ambient عبر Currentخاصية، ومحاولة القيام بهذه الحالة ينتج تم طرح استثناء.

The العمل الفعلي of التزام between the موارد المدير happens at the End Using كشف if the TransactionScope كائن تاريخ الإنشاء the عملية. If it did not إنشاء the عملية, the التزام occurs whenever Commit هو called بواسطة the مالك of the CommittableTransaction كائن. At that يؤشر the عملية المدير calls the مورد managers و informs them to either التزام أو العودة إلى الحالة السابقة, based تشغيل whether this أسلوب was called تشغيل the TransactionScope كائن.

يوضح المثال التالي كيفية إلى استخدام TransactionScopeفئة إلى تعريف حظر من تعليمات برمجية إلى المشاركة في المعاملات.


// This function takes arguments for 2 connection strings and commands to create a transaction 
// involving two SQL Servers. It returns a value > 0 if the transaction is committed, 0 if the 
// transaction is rolled back. To test this code, you can connect to two different databases 
// on the same server by altering the connection string, or to another 3rd party RDBMS by 
// altering the code in the connection2 code block.
static public int CreateTransactionScope(
    string connectString1, string connectString2,
    string commandText1, string commandText2)
{
    // Initialize the return value to zero and create a StringWriter to display results.
    int returnValue = 0;
    System.IO.StringWriter writer = new System.IO.StringWriter();

    try
    {
        // Create the TransactionScope to execute the commands, guaranteeing
        // that both commands can commit or roll back as a single unit of work.
        using (TransactionScope scope = new TransactionScope())
        {
            using (SqlConnection connection1 = new SqlConnection(connectString1))
            {
                // Opening the connection automatically enlists it in the 
                // TransactionScope as a lightweight transaction.
                connection1.Open();

                // Create the SqlCommand object and execute the first command.
                SqlCommand command1 = new SqlCommand(commandText1, connection1);
                returnValue = command1.ExecuteNonQuery();
                writer.WriteLine("Rows to be affected by command1: {0}", returnValue);

                // If you get here, this means that command1 succeeded. By nesting
                // the using block for connection2 inside that of connection1, you
                // conserve server and network resources as connection2 is opened
                // only when there is a chance that the transaction can commit.   
                using (SqlConnection connection2 = new SqlConnection(connectString2))
                {
                    // The transaction is escalated to a full distributed
                    // transaction when connection2 is opened.
                    connection2.Open();

                    // Execute the second command in the second database.
                    returnValue = 0;
                    SqlCommand command2 = new SqlCommand(commandText2, connection2);
                    returnValue = command2.ExecuteNonQuery();
                    writer.WriteLine("Rows to be affected by command2: {0}", returnValue);
                }
            }
        }

        // The Complete method commits the transaction. If an exception has been thrown,
        // Complete is not  called and the transaction is rolled back.
        scope.Complete();
    }
    catch (TransactionAbortedException ex)
    {
        writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message);
    }
    catch (ApplicationException ex)
    {
        writer.WriteLine("ApplicationException Message: {0}", ex.Message);
    }

    // Display messages.
    Console.WriteLine(writer.ToString());

    return returnValue;
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: