SqlConnection.Open Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Nelze otevřít připojení bez zadání zdroje dat nebo serveru.
nebo
Připojení je již otevřeno.
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.
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.
Platí pro
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
Nelze otevřít připojení bez zadání zdroje dat nebo serveru.
nebo
Připojení je již otevřeno.
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.
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.