SqlCommand.Connection Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает объект , используемый SqlConnection этим экземпляром SqlCommand .

public:
 property Microsoft::Data::SqlClient::SqlConnection ^ Connection { Microsoft::Data::SqlClient::SqlConnection ^ get(); void set(Microsoft::Data::SqlClient::SqlConnection ^ value); };

public Microsoft.Data.SqlClient.SqlConnection Connection { get; set; }

member this.Connection : Microsoft.Data.SqlClient.SqlConnection with get, set

Public Property Connection As SqlConnection

Значение свойства

SqlConnection

Соединение с источником данных. Значение по умолчанию —null .

Исключения

InvalidOperationException

Свойство Connection было изменено во время включения команды в список транзакции.

Примеры

В следующем примере создается SqlCommand и задаются некоторые его свойства.

// <Snippet1>
using System;
using System.Data;
using Microsoft.Data.SqlClient;


namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);
        }

        private static void CreateCommand(string queryString,
            string connectionString)
        {
            using (SqlConnection connection = new SqlConnection(
                       connectionString))
            {
                SqlCommand command = new SqlCommand();
                command.Connection = connection;
                command.CommandTimeout = 15;
                command.CommandType = CommandType.Text;
                command.CommandText = queryString;

                connection.Open();
                SqlDataReader reader = command.ExecuteReader();
                while (reader.Read())
                {
                    Console.WriteLine(String.Format("{0}, {1}",
                        reader[0], reader[1]));
                }
            }
        }
        // </Snippet1>
    }
}

Комментарии

Если команда включена в существующую транзакцию и подключение изменено, попытка выполнить команду вызовет InvalidOperationExceptionисключение .

Если свойство Transaction имеет значение, отличное от NULL, и транзакция уже зафиксирована или выполнен ее откат, то свойство Transaction устанавливается в значение NULL.