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

  • Ссылка

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Сборки:
netstandard.dll, System.Data.SqlClient.dll
Пакет:
System.Data.SqlClient v4.8.6

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

Перегрузки

SqlConnection()

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

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

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

SqlConnection()

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

public:
 SqlConnection();
public SqlConnection ();
Public Sub New ()

Примеры

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

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;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Комментарии

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

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

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

См. также раздел

Применяется к

SqlConnection(String)

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

public:
 SqlConnection(System::String ^ connectionString);
public SqlConnection (string connectionString);
new System.Data.SqlClient.SqlConnection : string -> System.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String)

Параметры

connectionString
String

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

Исключения

ArgumentException

Указанный аргумент строка подключения не проходит ConnectionString проверку.

Примеры

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

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;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection(connectionString)

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Комментарии

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

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

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

См. также раздел

Применяется к

SqlConnection(String, SqlCredential)

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

public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.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 проверку.

См. также раздел

Применяется к