DbConnection Třída
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í.
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ě |
| GetSchemaAsync(String, CancellationToken) |
Toto je asynchronní verze GetSchema(String).
Poskytovatelé by měli přepsat příslušnou implementací.
Volitelně |
| GetSchemaAsync(String, String[], CancellationToken) |
Toto je asynchronní verze GetSchema(String, String[]).
Poskytovatelé by měli přepsat příslušnou implementací.
Volitelně |
| 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 |
| 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í. |