SqlConnection Конструкторы

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

SqlConnection()	Инициализирует новый экземпляр класса SqlConnection.
SqlConnection(String)	Инициализирует новый экземпляр класса SqlConnection после получения строки, содержащей строку соединения.
SqlConnection(String, SqlCredential)	Инициализирует новый экземпляр класса SqlConnection, используя строку подключения, в которой не используется Integrated Security = true, и объект SqlCredential, содержащий идентификатор пользователя и пароль.

SqlConnection()

Инициализирует новый экземпляр класса SqlConnection.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Примеры

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

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();
            Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
            Console.WriteLine("State: {0}", connection.State);
        }
    }

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

Комментарии

При создании нового экземпляра SqlConnection свойству чтения и записи присваиваются следующие начальные значения, если только они не заданы с помощью связанных ключевых слов в свойстве ConnectionString .

Свойства	Начальное значение
ConnectionString	пустая строка ("")
ConnectionTimeout	15
Database	пустая строка ("")
DataSource	пустая строка ("")

Значение этих свойств можно изменить только через свойство ConnectionString. Класс предоставляет функциональные SqlConnectionStringBuilder возможности для создания содержимого строк подключения и управления ими.

SqlConnection(String)

Инициализирует новый экземпляр класса SqlConnection после получения строки, содержащей строку соединения.

public:
 SqlConnection(System::String ^ connectionString);

public SqlConnection (string connectionString);

new Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String)

Параметры

connectionString

String

Подключение, которое используется для открытия базы данных SQL Server.

Исключения

ArgumentException

Сбой проверки предоставленного аргумента ConnectionString строки подключения.

Примеры

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

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

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

Комментарии

При создании нового экземпляра SqlConnection свойству чтения и записи присваиваются следующие начальные значения, если только они не заданы с помощью связанных ключевых слов в свойстве ConnectionString .

Свойства	Начальное значение
ConnectionString	connectionString
ConnectionTimeout	15
Database	пустая строка ("")
DataSource	пустая строка ("")

Значение этих свойств можно изменить только через свойство ConnectionString. Класс предоставляет функциональные SqlConnection возможности для создания содержимого строк подключения и управления ими.

SqlConnection(String, SqlCredential)

Инициализирует новый экземпляр класса SqlConnection, используя строку подключения, в которой не используется Integrated Security = true, и объект SqlCredential, содержащий идентификатор пользователя и пароль.

public:
 SqlConnection(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlCredential ^ credential);

public SqlConnection (string connectionString, Microsoft.Data.SqlClient.SqlCredential credential);

new Microsoft.Data.SqlClient.SqlConnection : string * Microsoft.Data.SqlClient.SqlCredential -> Microsoft.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String, credential As SqlCredential)

Параметры

connectionString

String

Строка подключения, которая не использует какое-либо из следующих ключевых слов строки подключения: Integrated Security = true, UserId или Password, или не использует ContextConnection = true.

credential

SqlCredential

Объект SqlCredential. Если credential имеет значение NULL, то SqlConnection(String, SqlCredential) функционально эквивалентен SqlConnection(String).

Исключения

ArgumentException

Предоставленные аргументы не прошли проверку, включая ConnectionString проверку.