SqlConnection.Open Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Přetížení

Open()	Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.
Open(SqlConnectionOverrides)	Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.

Open()

Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.

public:
 override void Open();

public override void Open ();

override this.Open : unit -> unit

Public Overrides Sub Open ()

Výjimky

InvalidOperationException

Nelze otevřít připojení bez zadání zdroje dat nebo serveru.

nebo

Připojení je již otevřeno.

SqlException

Při otevírání připojení došlo k chybě na úrovni připojení. Number Pokud vlastnost obsahuje hodnotu 18487 nebo 18488, znamená to, že vypršela platnost zadaného hesla nebo se musí resetovat. Další informace najdete v ChangePassword(String, String) metodě .

Značka <system.data.localdb> v souboru app.config obsahuje neplatné nebo neznámé prvky.

ConfigurationErrorsException

Oddíl obsahuje dvě položky se stejným názvem <localdbinstances> .

Příklady

Následující příklad vytvoří objekt SqlConnection, otevře ho a zobrazí některé z jeho vlastností. Připojení se automaticky ukončí na konci using bloku.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

    private static void OpenSqlConnection(string connectionString)
    {
        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.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Poznámky

Nástroj SqlConnection nakreslí otevřené připojení z fondu připojení, pokud je k dispozici. V opačném případě vytvoří nové připojení k instanci SQL Server.

Poznámka

Pokud přejde mimo SqlConnection rozsah, neuzavře se. Proto je nutné explicitně ukončit připojení voláním Close.

Poznámka

Pokud při pokusu o připojení k instanci SQL Server a pomocí jiného protokolu než TCP/IP zadáte jiné číslo portu než 1433, Open metoda selže. Pokud chcete zadat jiné číslo portu než 1433, zahrňte do připojovacího řetězce "server=název_počítače,číslo portu" a použijte protokol TCP/IP.

Poznámka

Zprostředkovatel dat rozhraní .NET Framework pro SQL Server vyžaduje oprávnění Zabezpečení s povolenou možností Povolit volání nespravovaných sestavení (SecurityPermission s SecurityPermissionFlag nastavenou SqlConnection na UnmanagedCode) k otevření s povoleným laděním SQL.

Open(SqlConnectionOverrides)

Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.

public:
 void Open(Microsoft::Data::SqlClient::SqlConnectionOverrides overrides);

public void Open (Microsoft.Data.SqlClient.SqlConnectionOverrides overrides);

override this.Open : Microsoft.Data.SqlClient.SqlConnectionOverrides -> unit

Public Sub Open (overrides As SqlConnectionOverrides)

Parametry

overrides

SqlConnectionOverrides

Možnosti přepsání výchozího chování při otevírání připojení

Výjimky

InvalidOperationException

Nelze otevřít připojení bez zadání zdroje dat nebo serveru.

nebo

Připojení je již otevřeno.

SqlException

Při otevírání připojení došlo k chybě na úrovni připojení. Number Pokud vlastnost obsahuje hodnotu 18487 nebo 18488, znamená to, že vypršela platnost zadaného hesla nebo se musí resetovat. Další informace najdete v ChangePassword(String, String) metodě .

Značka <system.data.localdb> v souboru app.config obsahuje neplatné nebo neznámé prvky.

ConfigurationErrorsException

Oddíl obsahuje dvě položky se stejným názvem <localdbinstances> .

Příklady

Následující příklad vytvoří objekt SqlConnection, otevře ho a zobrazí některé z jeho vlastností. Připojení se automaticky ukončí na konci using bloku.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

    private static void OpenSqlConnection(string connectionString)
    {
        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.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Poznámky

Nástroj SqlConnection nakreslí otevřené připojení z fondu připojení, pokud je k dispozici. V opačném případě vytvoří nové připojení k instanci SQL Server. Pokud jsou zadána přepsání, při prvním pokusu o otevření se na akci Otevření použijí zadaná přepsání.

Poznámka

Pokud přejde mimo SqlConnection rozsah, neuzavře se. Proto je nutné explicitně ukončit připojení voláním Close.

Poznámka

Pokud při pokusu o připojení k instanci SQL Server a pomocí jiného protokolu než TCP/IP zadáte jiné číslo portu než 1433, Open metoda selže. Pokud chcete zadat jiné číslo portu než 1433, zahrňte do připojovacího řetězce "server=název_počítače,číslo portu" a použijte protokol TCP/IP.

Poznámka

Zprostředkovatel dat rozhraní .NET Framework pro SQL Server vyžaduje oprávnění Zabezpečení s povolenou možností Povolit volání nespravovaných sestavení (SecurityPermission s SecurityPermissionFlag nastavenou SqlConnection na UnmanagedCode) k otevření s povoleným laděním SQL.