SqlConnection Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

Představuje připojení k databázi SQL Server. Tato třída se nemůže dědit.

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable

type SqlConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable

Dědičnost

Object

DbConnection

SqlConnection

Implementuje

ICloneable

Příklady

Následující příklad vytvoří SqlCommand a SqlConnection. Otevře SqlConnection se a nastaví se jako Connection pro SqlCommand. Příklad pak volá ExecuteNonQuery. Za tímto účelem ExecuteNonQuery se předá připojovací řetězec a řetězec dotazu, který je příkazem TRANSACT-SQL INSERT. Připojení se automaticky ukončí, když kód ukončí blok using.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Poznámky

Objekt SqlConnection představuje jedinečnou relaci ke zdroji dat SQL Server. U databázového systému klient/server je ekvivalentem síťového připojení k serveru. SqlConnectionse používá společně s SqlDataAdapter a SqlCommand ke zvýšení výkonu při připojování k databázi Microsoft SQL Server. Pro všechny produkty SQL Server třetích stran a další zdroje dat podporované OLE DB použijte OleDbConnection.

Při vytváření instance nástroje SqlConnectionjsou všechny vlastnosti nastaveny na jejich počáteční hodnoty. Seznam těchto hodnot najdete v konstruktoru SqlConnection .

Podívejte ConnectionString se na seznam klíčových slov v připojovacím řetězci.

Pokud dojde k SqlConnection výpadku rozsahu, nezavře se. Proto musíte připojení explicitně zavřít voláním Close nebo Dispose. Close a Dispose jsou funkčně ekvivalentní. Pokud je hodnota Pooling sdružování připojení nastavená na true nebo yes, vrátí se podkladové připojení zpět do fondu připojení. Na druhou stranu, pokud Pooling je nastaven na false nebo no, základní připojení k serveru je ve skutečnosti uzavřeno.

Poznámka

Události přihlášení a odhlášení nebudou vyvolány na serveru, pokud je připojení načteno z fondu připojení nebo vráceno do fondu připojení, protože připojení není ve skutečnosti ukončeno, jakmile se vrátí do fondu připojení. Další informace najdete v tématu SQL Server sdružování připojení (ADO.NET).

Pokud chcete zajistit, aby připojení byla vždy uzavřena, otevřete připojení uvnitř using bloku, jak je znázorněno v následujícím fragmentu kódu. Tím zajistíte, že se připojení automaticky ukončí, když kód ukončí blok.

Using connection As New SqlConnection(connectionString)
    connection.Open()
    ' Do work here; connection closed on following line.
End Using

using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        // Do work here; connection closed on following line.
    }

Poznámka

Pokud chcete nasadit vysoce výkonné aplikace, musíte použít sdružování připojení. Při použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server není nutné povolit sdružování připojení, protože zprostředkovatel to spravuje automaticky, i když můžete upravit některá nastavení. Další informace najdete v tématu SQL Server sdružování připojení (ADO.NET).

SqlException Pokud je vygenerován metodou, SqlCommandkterá spouští , SqlConnection zůstane otevřený, pokud je úroveň závažnosti 19 nebo nižší. Pokud je úroveň závažnosti 20 nebo vyšší, server obvykle zavře SqlConnection. Uživatel ale může připojení znovu otevřít a pokračovat.

Aplikace, která vytvoří instanci objektu SqlConnection , může vyžadovat, aby všichni přímí i nepřímí volající měli dostatečná oprávnění ke kódu nastavením deklarativních nebo imperativních požadavků na zabezpečení. SqlConnection vytváří požadavky na zabezpečení pomocí objektu SqlClientPermission . Uživatelé můžou pomocí objektu SqlClientPermissionAttribute ověřit, jestli má jejich kód dostatečná oprávnění. Uživatelé a správci můžou také pomocí nástrojeCaspol.exe (Code Access Security Policy Tool) upravovat zásady zabezpečení na úrovni počítače, uživatele a organizace. Další informace najdete v tématu Zabezpečení v .NET. Příklad, jak používat požadavky na zabezpečení, najdete v tématu Zabezpečení přístupu kódu a ADO.NET.

Další informace o zpracování upozornění a informačních zpráv ze serveru najdete v tématu Události připojení. Další informace o chybách a chybových zprávách modulu SQL Server najdete v tématu Události a chyby databázového stroje.

Upozornění

Místo sdílené paměti můžete vynutit protokol TCP. Můžete to udělat tak, že do názvu serveru v připojovacím řetězci přidáte předponu tcp: nebo můžete použít localhost.

Konstruktory

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.

Vlastnosti

AccessToken	Získá nebo nastaví přístupový token pro připojení.
CanCreateBatch	Získá hodnotu, která označuje, zda tato DbConnection instance podporuje DbBatch třídu . (Zděděno od DbConnection)
ClientConnectionId	ID připojení posledního pokusu o připojení bez ohledu na to, jestli byl pokus úspěšný nebo neúspěšný.
ConnectionString	Získá nebo nastaví řetězec použitý k otevření databáze SQL Server.
ConnectionTimeout	Získá dobu čekání (v sekundách) při pokusu o navázání připojení před ukončením pokusu a generování chyby.
Credential	Získá nebo nastaví SqlCredential objekt pro toto připojení.
Database	Získá název aktuální databáze nebo databáze, která má být použita po otevření připojení.
DataSource	Získá název instance SQL Server, ke kterému se připojit.
DbProviderFactory	Získá pro DbProviderFactory tento DbConnectionobjekt . (Zděděno od DbConnection)
FireInfoMessageEventOnUserErrors	Získá nebo nastaví FireInfoMessageEventOnUserErrors vlastnost.
PacketSize	Získá velikost (v bajtech) síťových paketů používaných ke komunikaci s instancí SQL Server.
ServerVersion	Získá řetězec, který obsahuje verzi instance SQL Server, ke kterému je klient připojen.
State	Označuje stav SqlConnection během poslední síťové operace provedené na připojení.
StatisticsEnabled	Pokud je tato možnost nastavená na true, povolí shromažďování statistik pro aktuální připojení.
WorkstationId	Získá řetězec, který identifikuje klienta databáze.

Metody

BeginDbTransaction(IsolationLevel)	Při přepsání v odvozené třídě spustí transakci databáze. (Zděděno od DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně spustí transakci databáze. (Zděděno od DbConnection)
BeginTransaction()	Spustí transakci databáze.
BeginTransaction(IsolationLevel)	Spustí databázovou transakci se zadanou úrovní izolace.
BeginTransaction(IsolationLevel, String)	Spustí databázovou transakci se zadanou úrovní izolace a názvem transakce.
BeginTransaction(String)	Spustí databázovou transakci se zadaným názvem transakce.
BeginTransactionAsync(CancellationToken)	Asynchronně zahájí transakci databáze. (Zděděno od DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně zahájí transakci databáze. (Zděděno od DbConnection)
ChangeDatabase(String)	Změní aktuální databázi otevřeného objektu SqlConnection.
ChangeDatabaseAsync(String, CancellationToken)	Asynchronně změní aktuální databázi pro otevřené připojení. (Zděděno od DbConnection)
ChangePassword(String, SqlCredential, SecureString)	Změní heslo SQL Server uživatele uvedeného v objektu SqlCredential .
ChangePassword(String, String)	Změní heslo SQL Server uživatele uvedeného v připojovacím řetězci na zadané nové heslo.
ClearAllPools()	Vyprázdní fond připojení.
ClearPool(SqlConnection)	Vyprázdní fond připojení přidružený k zadanému připojení.
Close()	Ukončí připojení k databázi. Toto je upřednostňovaná metoda ukončení jakéhokoli otevřeného připojení.
CloseAsync()	Asynchronně ukončí připojení k databázi. (Zděděno od DbConnection)
CreateBatch()	Vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu . (Zděděno od DbConnection)
CreateCommand()	Vytvoří a vrátí SqlCommand objekt přidružený k objektu SqlConnection.
CreateDbBatch()	Při přepsání v odvozené třídě vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu . (Zděděno od DbConnection)
CreateDbCommand()	Při přepsání v odvozené třídě vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení. (Zděděno od DbConnection)
Dispose()	Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbConnection)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem DbConnection a volitelně uvolní spravované prostředky. (Zděděno od DbConnection)
DisposeAsync()	Asynchronně rozloží objekt připojení. (Zděděno od DbConnection)
EnlistTransaction(Transaction)	Zadává v zadané transakci jako distribuovanou transakci.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetSchema()	Vrátí informace o schématu pro zdroj dat tohoto SqlConnection. Další informace o schématu najdete v tématu SQL Server kolekce schémat.
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto SqlConnection typu pomocí zadaného řetězce pro název schématu.
GetSchema(String, String[])	Vrátí informace o schématu pro zdroj dat tohoto SqlConnection typu pomocí zadaného řetězce pro název schématu a zadaného pole řetězců pro hodnoty omezení.
GetSchemaAsync(CancellationToken)	Toto je asynchronní verze nástroje GetSchema(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetSchemaAsync(String, CancellationToken)	Toto je asynchronní verze nástroje GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema(String) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema(String) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Toto je asynchronní verze nástroje GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema(String, String[]) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema(String, String[]) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnStateChange(StateChangeEventArgs)	StateChange Vyvolá událost. (Zděděno od DbConnection)
Open()	Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.
OpenAsync()	Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením určeným parametrem ConnectionString. Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbConnection)
OpenAsync(CancellationToken)	Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením vlastnosti určeným ConnectionStringnástrojem . Pomocí tokenu zrušení můžete požádat o opuštění operace před vypršením časového limitu připojení. Výjimky se rozšíří prostřednictvím vrácené úlohy. Pokud časový limit připojení uplyne bez úspěšného připojení, bude vrácená úloha označena jako chybná s výjimkou. Implementace vrátí úlohu bez blokování volajícího vlákna pro připojení ve fondu i připojení bez fondu.
ResetStatistics()	Pokud je shromažďování statistik povolené, všechny hodnoty se resetují na nulu.
RetrieveStatistics()	Vrátí kolekci párů hodnot názvů statistik v okamžiku, kdy je volána metoda.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

InfoMessage	Nastane, když SQL Server vrátí upozornění nebo informační zprávu.
StateChange	Vyvolá se při změně stavu připojení. (Zděděno od DbConnection)

Explicitní implementace rozhraní

ICloneable.Clone()

Vytváří nový objekt, který je kopií aktuální instance.

Viz také

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