Sdílet prostřednictvím

SqlConnection Konstruktory

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll, System.Data.SqlClient.dll
Balíček:
System.Data.SqlClient v4.8.6

Inicializuje novou instanci SqlConnection třídy .

Přetížení

SqlConnection()

Inicializuje novou instanci SqlConnection třídy .
SqlConnection(String)

Inicializuje novou instanci SqlConnection třídy při zadání řetězce, který obsahuje připojovací řetězec.
SqlConnection(String, SqlCredential)

Inicializuje novou instanci SqlConnection třídy dané připojovací řetězec, která nepoužívá Integrated Security = true a SqlCredential objekt, který obsahuje ID uživatele a heslo.

SqlConnection()

Inicializuje novou instanci SqlConnection třídy .

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

Příklady

Následující příklad vytvoří a otevře 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

Poznámky

Při vytvoření nové instance objektu SqlConnection jsou vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty, pokud nejsou specificky nastaveny pomocí přidružených klíčových slov ve ConnectionString vlastnosti .

Vlastnosti Počáteční hodnota
ConnectionString prázdný řetězec ("")
ConnectionTimeout 15
Database prázdný řetězec ("")
DataSource prázdný řetězec ("")

Hodnotu těchto vlastností můžete změnit pouze pomocí ConnectionString vlastnosti . Třída SqlConnectionStringBuilder poskytuje funkce pro vytváření a správu obsahu připojovacích řetězců.

Viz také

Platí pro

SqlConnection(String)

Inicializuje novou instanci SqlConnection třídy při zadání řetězce, který obsahuje připojovací řetězec.

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)

Parametry

connectionString
String

Připojení použité k otevření databáze SQL Server.

Výjimky

ArgumentException

Ověření zadaného argumentu připojovací řetězec se nezdařiloConnectionString.

Příklady

Následující příklad vytvoří a otevře 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

Poznámky

Při vytvoření nové instance objektu SqlConnection jsou vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty, pokud nejsou specificky nastaveny pomocí přidružených klíčových slov ve ConnectionString vlastnosti .

Vlastnosti Počáteční hodnota
ConnectionString connectionString
ConnectionTimeout 15
Database prázdný řetězec ("")
DataSource prázdný řetězec ("")

Hodnotu těchto vlastností můžete změnit pouze pomocí ConnectionString vlastnosti . Třída SqlConnection poskytuje funkce pro vytváření a správu obsahu připojovacích řetězců.

Viz také

Platí pro

SqlConnection(String, SqlCredential)

Inicializuje novou instanci SqlConnection třídy dané připojovací řetězec, která nepoužívá Integrated Security = true a SqlCredential objekt, který obsahuje ID uživatele a heslo.

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)

Parametry

connectionString
String

Připojovací řetězec, která nepoužívá žádné z následujících připojovací řetězec klíčových slov: Integrated Security = true, UserIdnebo Password; nebo nepoužívá ContextConnection = true.

credential
SqlCredential

Objekt SqlCredential . Pokud credential je null, SqlConnection(String, SqlCredential) je funkčně ekvivalentní k SqlConnection(String).

Výjimky

ArgumentException

Ověření zadaného argumentu připojovací řetězec se nezdařiloConnectionString.

Viz také

Platí pro