SqlConnection Konstruktory

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Przeciążenia

SqlConnection()	Inicjuje nowe wystąpienie klasy SqlConnection.
SqlConnection(String)	Inicjuje SqlConnection nowe wystąpienie klasy, gdy podane parametry, które zawierają parametry połączenia.
SqlConnection(String, SqlCredential)	Inicjuje nowe wystąpienie SqlConnection klasy przy użyciu parametrów połączenia, które nie jest używane Integrated Security = true i SqlCredential obiekt, który zawiera identyfikator użytkownika i hasło.

SqlConnection()

Inicjuje nowe wystąpienie klasy SqlConnection.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Przykłady

Poniższy przykład tworzy i otwiera obiekt 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;";
    }
}

Uwagi

Po utworzeniu SqlConnection nowego wystąpienia właściwości odczytu/zapisu są ustawione na następujące wartości początkowe, chyba że zostały one specjalnie ustawione przy użyciu skojarzonych słów kluczowych we ConnectionString właściwości.

Właściwości	Wartość początkowa
ConnectionString	pusty ciąg ("")
ConnectionTimeout	15
Database	pusty ciąg ("")
DataSource	pusty ciąg ("")

Wartość tych właściwości można zmienić tylko przy użyciu ConnectionString właściwości . Klasa SqlConnectionStringBuilder udostępnia funkcje tworzenia zawartości parametrów połączenia i zarządzania nimi.

SqlConnection(String)

Inicjuje SqlConnection nowe wystąpienie klasy, gdy podane parametry, które zawierają parametry połączenia.

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)

Parametry

connectionString

String

Połączenie używane do otwierania bazy danych SQL Server.

Wyjątki

ArgumentException

Podany argument parametrów połączenia zakończył się niepowodzeniem ConnectionString walidacji.

Przykłady

Poniższy przykład tworzy i otwiera obiekt 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;";
    }
}

Uwagi

Po utworzeniu SqlConnection nowego wystąpienia właściwości odczytu/zapisu są ustawione na następujące wartości początkowe, chyba że zostały one specjalnie ustawione przy użyciu skojarzonych słów kluczowych we ConnectionString właściwości.

Właściwości	Wartość początkowa
ConnectionString	connectionString
ConnectionTimeout	15
Database	pusty ciąg ("")
DataSource	pusty ciąg ("")

Wartość tych właściwości można zmienić tylko przy użyciu ConnectionString właściwości . Klasa SqlConnection udostępnia funkcje tworzenia zawartości parametrów połączenia i zarządzania nimi.

SqlConnection(String, SqlCredential)

Inicjuje nowe wystąpienie SqlConnection klasy przy użyciu parametrów połączenia, które nie jest używane Integrated Security = true i SqlCredential obiekt, który zawiera identyfikator użytkownika i hasło.

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)

Parametry

connectionString

String

Parametry połączenia, które nie używają żadnego z następujących słów kluczowych parametrów połączenia: Integrated Security = true, lub UserIdPassword; lub, które nie używają ContextConnection = true.

credential

SqlCredential

Obiekt SqlCredential. Jeśli credential wartość ma wartość null, SqlConnection(String, SqlCredential) jest funkcjonalnie równoważna .SqlConnection(String)

Wyjątki

ArgumentException

Podane argumenty zakończyły się niepowodzeniem weryfikacji, w tym ConnectionString walidacji.