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í databázová připojení a poskytuje základní třídu pro připojení specifická pro databázi.
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
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() |
Provede aplikací definované úlohy spojené s 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é nástrojem DbConnection a volitelně uvolní spravované prostředky. |
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ě |
GetSchemaAsync(String, CancellationToken) |
Toto je asynchronní verze nástroje GetSchema(String).
Poskytovatelé by měli přepsat příslušnou implementací.
Volitelně |
GetSchemaAsync(String, String[], CancellationToken) |
Toto je asynchronní verze nástroje 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 .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 |
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 , 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. |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro