DbConnection Třída

Definice

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

public ref class DbConnection abstract : IDisposable
public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbConnection
public abstract class DbConnection : IDisposable
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbConnection
type DbConnection = class
    interface IDisposable
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable
type DbConnection = class
    interface IDbConnection
    interface IDisposable
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
Public MustInherit Class DbConnection
Implements IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable
Public MustInherit Class DbConnection
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection
Dědičnost
DbConnection
Dědičnost
Odvozené
Implementuje

Poznámky pro implementátory

Při dědění 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

Name Description
DbConnection()

Inicializuje novou instanci DbConnection třídy.

Vlastnosti

Name Description
CanCreateBatch

Získá hodnotu, která určuje, zda tato DbConnection instance podporuje DbBatch třídu.

CanRaiseEvents

Získá hodnotu urč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á ten 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 připojit.

DbProviderFactory

DbProviderFactory Získá pro to DbConnection.

DesignMode

Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu.

(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 objektu Component.

(Zděděno od Component)
State

Získá hodnotu, která popisuje stav připojení.

Metody

Name Description
BeginDbTransaction(IsolationLevel)

Při přepsání v odvozené třídě, spustí databázové transakce.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Asynchronně spustí databázovou transakci.

BeginTransaction()

Spustí databázovou transakci.

BeginTransaction(IsolationLevel)

Spustí databázovou transakci se zadanou úrovní izolace.

BeginTransactionAsync(CancellationToken)

Asynchronní zahájení databázové transakce.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Asynchronní zahájení databázové transakce.

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ě zavře připojení k databázi.

CloseAsync()

Asynchronně zavře 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 serveru sloužícího ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků.

Dispose()

Uvolní všechny prostředky používané nástrojem Component.

(Zděděno od Component)
Dispose(Boolean)

Uvolní nespravované prostředky používané DbConnection a volitelně uvolní spravované prostředky.

Dispose(Boolean)

Uvolní nespravované prostředky používané Component a volitelně uvolní spravované prostředky.

(Zděděno od Component)
DisposeAsync()

Asynchronně odstraní objekt připojení.

EnlistTransaction(Transaction)

Zapsá do zadané transakce.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetSchema()

Vrátí informace o schématu pro zdroj dat tohoto DbConnectionobjektu .

GetSchema(String, String[])

Vrátí informace o schématu pro zdroj dat tohoto DbConnection pomocí zadaného řetězce pro název schématu a zadané pole řetězců pro hodnoty omezení.

GetSchema(String)

Vrátí informace o schématu pro zdroj dat tohoto DbConnection pomocí zadaného řetězce pro název schématu.

GetSchemaAsync(CancellationToken)

Toto je asynchronní verze .GetSchema() Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken lze respektovat. Výchozí implementace vyvolá synchronní GetSchema() volání a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byl zrušen cancellationToken. Výjimky vyvolané GetSchema() výjimkou budou oznámeny prostřednictvím vrácené vlastnosti Exception úkolu.

GetSchemaAsync(String, CancellationToken)

Toto je asynchronní verze GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken lze respektovat. Výchozí implementace vyvolá synchronní GetSchema(String) volání a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byl zrušen cancellationToken. Výjimky vyvolané GetSchema(String) výjimkou budou oznámeny prostřednictvím vrácené vlastnosti Exception úkolu.

GetSchemaAsync(String, String[], CancellationToken)

Toto je asynchronní verze GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken lze respektovat. Výchozí implementace vyvolá synchronní GetSchema(String, String[]) volání a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byl zrušen cancellationToken. Výjimky vyvolané GetSchema(String, String[]) výjimkou budou oznámeny prostřednictvím vrácené vlastnosti Exception úkolu.

GetService(Type)

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container.

(Zděděno od Component)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(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í databáze s nastavením určeným ConnectionString.

OpenAsync()

Asynchronní verze Open(), která otevře připojení databáze s nastavením určeným ConnectionString. Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) pomocí CancellationToken.None.

OpenAsync(CancellationToken)

Toto je asynchronní verze Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení lze volitelně respektovat.

Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již bylo zrušeno cancellationToken. Výjimky vyvolané příkazem Open budou oznámeny prostřednictvím vrácené vlastnosti Exception úkolu.

Nevyvolejte jiné metody a vlastnosti objektu DbConnection , dokud nebude vrácena úloha dokončena.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
ToString()

String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána.

(Zděděno od Component)

Událost

Name Description
Disposed

Nastane, když komponenta je uvolněna voláním Dispose() metody.

(Zděděno od Component)
StateChange

Nastane, když se změní stav připojení.

Explicitní implementace rozhraní

Name Description
IDbConnection.BeginTransaction()

Začne databázovou transakci.

IDbConnection.BeginTransaction(IsolationLevel)

Zahájí transakci databáze se zadanou úrovní izolace.

IDbConnection.CreateCommand()

Vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení.

Metody rozšíření

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Viz také