SqlConnection Konstruktory

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Inicializuje novou instanci SqlConnection třídy.

Přetížení

Name	Description
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 s daným připojovacím řetězcem, 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 SqlConnection jsou vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty, pokud nejsou výslovně 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é

• Připojení ke zdroji dat v ADO.NET
• SQL Server a ADO.NET
• Přehled ADO.NET

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 Serveru.

Výjimky

ArgumentException

Zadaného argumentu připojovacího řetězce se nepodařilo ConnectionString ověřit.

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 SqlConnection jsou vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty, pokud nejsou výslovně 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é

• Připojení ke zdroji dat (ADO.NET)
• Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
• Přehled ADO.NET

SqlConnection(String, SqlCredential)

Inicializuje novou instanci SqlConnection třídy s daným připojovacím řetězcem, 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 klíčových slov připojovacího řetězce: Integrated Security = true, UserIdnebo Password; nebo který nepoužívá ContextConnection = true.

credential

SqlCredential

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

Výjimky

ArgumentException

Zadaného argumentu připojovacího řetězce se nepodařilo ConnectionString ověřit.

Viz také

• Přehled ADO.NET