SqlConnectionStringBuilder.AsynchronousProcessing Właściwość

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Pobiera lub ustawia wartość logiczną wskazującą, czy przetwarzanie asynchroniczne jest dozwolone przez połączenie utworzone przy użyciu tego parametry połączenia.

public bool AsynchronousProcessing { get; set; }

Wartość właściwości

Boolean

Wartość AsynchronousProcessing właściwości lub false jeśli nie podano żadnej wartości.

Przykłady

Poniższy przykład pobiera parametry połączenia i sprawdza, czy parametry połączenia jest skonfigurowany do zezwalania na przetwarzanie asynchroniczne. (W tym przypadku ciąg pochodzi z procedury w aplikacji, ale w aplikacji produkcyjnej parametry połączenia może pochodzić z pliku konfiguracji lub innego źródła). Następnie przykład wykonuje operację asynchroniczną, aktualizując wartości w przykładowej bazie danych w wątku w tle.

using System.Data.SqlClient;
using System.Threading;

class Program
{
    static void Main()
    {
        // Create a SqlConnectionStringBuilder instance,
        // and ensure that it is set up for asynchronous processing.
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(GetConnectionString());
        // Asynchronous method calls won't work unless you
        // have added this option, or have added
        // the clause "Asynchronous Processing=true"
        // to the connection string.
        builder.AsynchronousProcessing = true;

        string commandText =
            "UPDATE Production.Product SET ReorderPoint = ReorderPoint + 1 " +
            "WHERE ReorderPoint IS NOT Null;" +
            "WAITFOR DELAY '0:0:3';" +
            "UPDATE Production.Product SET ReorderPoint = ReorderPoint - 1 " +
            "WHERE ReorderPoint IS NOT Null";
        RunCommandAsynchronously(commandText, builder.ConnectionString);

        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks";
    }

    private static void RunCommandAsynchronously(string commandText,
        string connectionString)
    {
        // Given command text and connection string, asynchronously execute
        // the specified command against the connection. For this example,
        // the code displays an indicator as it's working, verifying the
        // asynchronous behavior.
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            try
            {
                int count = 0;
                SqlCommand command = new SqlCommand(commandText, connection);
                connection.Open();
                IAsyncResult result = command.BeginExecuteNonQuery();
                while (!result.IsCompleted)
                {
                    Console.WriteLine("Waiting {0}.", count);
                    // Wait for 1/10 second, so the counter
                    // doesn't consume all available resources
                    // on the main thread.
                    Thread.Sleep(100);
                    count += 1;
                }
                Console.WriteLine("Command complete. Affected {0} rows.",
                    command.EndExecuteNonQuery(result));
            }
            catch (SqlException ex)
            {
                Console.WriteLine(
                    "Error {0}: System.Data.SqlClient.SqlConnectionStringBuilder",
                    ex.Number, ex.Message);
            }
            catch (InvalidOperationException ex)
            {
                Console.WriteLine("Error: {0}", ex.Message);
            }
            catch (Exception ex)
            {
                // You might want to pass these errors
                // back out to the caller.
                Console.WriteLine("Error: {0}", ex.Message);
            }
        }
    }
}

Uwagi

Ta właściwość odpowiada kluczom "Przetwarzanie asynchroniczne" i "asynchroniczne" w parametry połączenia. Aby móc korzystać z przetwarzania asynchronicznego dostarczonego przez SqlCommand obiekt, ta para klucz/wartość musi zostać uwzględniona w parametry połączenia skojarzonego SqlConnection obiektu.

Dotyczy

Zobacz też

• BeginExecuteReader()
• BeginExecuteNonQuery()
• BeginExecuteXmlReader()
• Parametry połączenia w ADO.NET
• Omówienie ADO.NET