DbConnection Třída

Reference

Definice

Obor názvů:: System.Data.Common

Sestavení:: System.Data.Common.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll

Zdroj:: DbConnection.cs

Zdroj:: DbConnection.cs

Zdroj:: DbConnection.cs

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: Object
DbConnection

Dědičnost: Object

MarshalByRefObject

Component
DbConnection

Odvozené: System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.OracleClient.OracleConnection

System.Data.SqlClient.SqlConnection

Implementuje: IDisposable IDbConnection IAsyncDisposable

Poznámky pro implementátory

Při dědění z DbConnectionje nutné 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řídy.
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á 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ím řetězci 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	Získá DbProviderFactory pro tento 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 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í 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 třídu DbBatch.
CreateCommand()	Vytvoří a vrátí objekt DbCommand 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řídy.
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é 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ě dispozuje 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 DbConnection.
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto DbConnection pomocí zadaného řetězce pro název schématu.
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í.
GetSchemaAsync(CancellationToken)	Toto je asynchronní verze GetSchema(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně je možné respektovat `cancellationToken`. Výchozí implementace vyvolá synchronní volání GetSchema() a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byla zrušena `cancellationToken`. Výjimky vyvolané GetSchema() budou předány prostřednictvím vrácené vlastnosti Exception úlohy.
GetSchemaAsync(String, CancellationToken)	Toto je asynchronní verze GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně je možné respektovat `cancellationToken`. Výchozí implementace vyvolá synchronní volání GetSchema(String) a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byla zrušena `cancellationToken`. Výjimky vyvolané GetSchema(String) budou předány prostřednictvím vrácené vlastnosti Exception úlohy.
GetSchemaAsync(String, String[], CancellationToken)	Toto je asynchronní verze GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně je možné respektovat `cancellationToken`. Výchozí implementace vyvolá synchronní volání GetSchema(String, String[]) a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byla zrušena `cancellationToken`. Výjimky vyvolané GetSchema(String, String[]) budou předány prostřednictvím vrácené vlastnosti Exception úlohy.
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou 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 objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Vyvolá událost StateChange.
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í volání Open() 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 `DbConnection` objektu, dokud vrácená úloha není dokončena.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
ToString()	Vrátí String obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

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í

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í objekt DbCommand, který je přidružen k aktuálnímu připojení.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

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

Platí pro

Viz také

DbProviderFactories (ADO.NET)
přehled ADO.NET

Sdílet prostřednictvím