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

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.SqlClient.dll

Сборка:: System.Data.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

SqlConnection()

Исходный код:: System.Data.SqlClient.notsupported.cs

Инициализирует новый экземпляр класса 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)

Исходный код:: System.Data.SqlClient.notsupported.cs

Инициализирует новый экземпляр 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

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

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

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

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

SqlConnection(String, SqlCredential)

Исходный код:: System.Data.SqlClient.notsupported.cs

Инициализирует новый экземпляр 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 проверки.

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

Общие сведения об ADO.NET

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

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

Определение

Перегрузки

SqlConnection()

Примеры

Комментарии

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

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

SqlConnection(String)

Параметры

Исключения

Примеры

Комментарии

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

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

SqlConnection(String, SqlCredential)

Параметры

Исключения

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

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