SqlConnection Konstruktory

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

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 zadaný 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.

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

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

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 Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.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ího řetězce se nezdařilo ConnectionString .

Příklady

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

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

SqlConnection(String, SqlCredential)

Inicializuje novou instanci SqlConnection třídy zadaný 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, 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

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í k SqlConnection(String).

Výjimky

ArgumentException

Zadané argumenty se nepodařilo ověřit, včetně ConnectionString ověření.