DbConnection Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Zdroj:

DbConnection.cs

Definuje základní chování databázová připojení a poskytuje základní třídu pro připojení specifická pro databázi.

public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection

public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable

Dědičnost

Object

MarshalByRefObject

Component

DbConnection

Odvozené

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Implementuje

IDisposable IDbConnection IAsyncDisposable

Poznámky pro implementátory

Když dědíte z DbConnection, musíte přepsat následující členy: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open()a StateChange. Musíte také zadat následující vlastnosti: ConnectionString, Database, DataSource, ServerVersiona State.

Konstruktory

DbConnection()

Inicializuje novou instanci DbConnection třídy .

Vlastnosti

CanCreateBatch	Získá hodnotu, která označuje, zda tato DbConnection instance podporuje DbBatch třídu .
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
ConnectionString	Při přepsání v odvozené třídě získá nebo nastaví řetězec použitý k otevření připojení.
ConnectionTimeout	Získá čas čekání (v sekundách) při navazování připojení před ukončením pokusu a generování chyby.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
Database	Při přepsání v odvozené třídě získá název aktuální databáze po otevření připojení nebo název databáze zadaný v připojovací řetězec před otevřením připojení.
DataSource	Při přepsání v odvozené třídě získá název databázového serveru, ke kterému se chcete připojit.
DbProviderFactory	Získá pro DbProviderFactory tento DbConnectionobjekt .
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
ServerVersion	Při přepsání v odvozené třídě získá řetězec, který představuje verzi serveru, ke kterému je objekt připojen.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
State	Získá řetězec, který popisuje stav připojení.

Metody

BeginDbTransaction(IsolationLevel)	Při přepsání v odvozené třídě spustí transakci databáze.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně spustí transakci databáze.
BeginTransaction()	Spustí transakci databáze.
BeginTransaction(IsolationLevel)	Spustí databázovou transakci se zadanou úrovní izolace.
BeginTransactionAsync(CancellationToken)	Asynchronně zahájí transakci databáze.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně zahájí transakci databáze.
ChangeDatabase(String)	Při přepsání v odvozené třídě změní aktuální databázi pro otevřené připojení.
ChangeDatabaseAsync(String, CancellationToken)	Asynchronně změní aktuální databázi pro otevřené připojení.
Close()	Při přepsání v odvozené třídě nástroj ukončí připojení k databázi.
CloseAsync()	Asynchronně ukončí připojení k databázi.
CreateBatch()	Vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu .
CreateCommand()	Vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení.
CreateDbBatch()	Při přepsání v odvozené třídě vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu .
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í.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
DisposeAsync()	Asynchronně rozloží objekt připojení.
EnlistTransaction(Transaction)	Enlists v zadané transakce.
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)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetSchema()	Vrátí informace o schématu pro zdroj dat tohoto DbConnection.
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto DbConnection typu pomocí zadaného řetězce pro název schématu.
GetSchema(String, String[])	Vrátí informace o schématu pro zdroj dat tohoto DbConnection 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).
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).
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).
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	StateChange Vyvolá událost.
Open()	Při přepsání v odvozené třídě otevře připojení k databázi s nastavením určeným ConnectionStringv .
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.
OpenAsync(CancellationToken)	Toto je asynchronní verze nástroje Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení je možné volitelně respektovat. Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený cancellationToken. Výjimky vyvolané otevřením budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úlohy). Nevyvolávej jiné metody a vlastnosti objektu DbConnection , dokud vrácená úloha není dokončena.
ToString()	String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
StateChange	Vyvolá se při změně stavu připojení.

Explicitní implementace rozhraní

IDbConnection.BeginTransaction()	Zahájí transakci databáze.
IDbConnection.BeginTransaction(IsolationLevel)	Začíná databázovou transakci se zadanou úrovní izolace.
IDbConnection.CreateCommand()	Vytvoří a vrátí DbCommand objekt, který je přidružen k aktuálnímu připojení.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce awaits u úloh vrácených z asynchronního jednorázového režimu.

Viz také

• DbProviderFactories (ADO.NET)
• Přehled ADO.NET