DbConnection Třída

Definice

Definuje základní chování databázových připojení a poskytuje základní třídu pro připojení specifická pro databázi.Defines the core behavior of database connections and provides a base class for database-specific connections.

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 je DbConnection nutné přepsat následující členy: Close() , BeginDbTransaction(IsolationLevel) , ChangeDatabase(String) , CreateDbCommand() , Open() a StateChange .When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. Je nutné zadat také následující vlastnosti: ConnectionString , Database , DataSource , ServerVersion a State .You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Konstruktory

DbConnection()

Inicializuje novou instanci DbConnection třídy.Initializes a new instance of the DbConnection class.

Vlastnosti

CanRaiseEvents

Získá hodnotu, která označuje, zda může komponenta vyvolat událost.Gets a value indicating whether the component can raise an event.

(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í.When overridden in a derived class, gets or sets the string used to open the connection.

ConnectionTimeout

Před ukončením pokusu a vygenerováním chyby Získá čas čekání (v sekundách) při navazování připojení.Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

Získá IContainer , který obsahuje Component .Gets the IContainer that contains the 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í.When overridden in a derived class, gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

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.When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory

Získá DbProviderFactory DbConnection .Gets the DbProviderFactory for this DbConnection.

DesignMode

Načte hodnotu, která označuje, zda Component je aktuálně v režimu návrhu.Gets a value that indicates whether the Component is currently in design mode.

(Zděděno od Component)
Events

Získá seznam obslužných rutin událostí, které jsou k tomuto typu připojeny Component .Gets the list of event handlers that are attached to this 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.When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site

Získá nebo nastaví ISite z Component .Gets or sets the ISite of the Component.

(Zděděno od Component)
State

Načte řetězec, který popisuje stav připojení.Gets a string that describes the state of the connection.

Metody

BeginDbTransaction(IsolationLevel)

Při přepsání v odvozené třídě spustí databázovou transakci.When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Asynchronně spustí databázovou transakci.Asynchronously starts a database transaction.

BeginTransaction()

Spustí transakci databáze.Starts a database transaction.

BeginTransaction(IsolationLevel)

Spustí databázovou transakci se zadanou úrovní izolace.Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken)

Asynchronně zahájí databázovou transakci.Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Asynchronně zahájí databázovou transakci.Asynchronously begins a database transaction.

ChangeDatabase(String)

Při přepsání v odvozené třídě změní aktuální databázi otevřeného připojení.When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken)

Asynchronně změní aktuální databázi otevřeného připojení.Asynchronously changes the current database for an open connection.

Close()

Při přepsání v odvozené třídě ukončí připojení k databázi.When overridden in a derived class, closes the connection to the database.

CloseAsync()

Asynchronně uzavře připojení k databázi.Asynchronously closes the connection to the database.

CreateCommand()

Vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení.Creates and returns a DbCommand object associated with the current connection.

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í.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

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

Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Uvolní všechny prostředky, které používá Component .Releases all resources used by the Component.

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

Uvolní nespravované prostředky používané DbConnection a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the DbConnection and optionally releases the managed resources.

Dispose(Boolean)

Uvolní nespravované prostředky používané Component a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

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

Asynchronně vynutí objekt připojení.Asynchronously diposes the connection object.

EnlistTransaction(Transaction)

Zařadí do zadané transakce.Enlists in the specified transaction.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

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

Slouží jako výchozí funkce hash.Serves as the default hash function.

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

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Vrátí informace o schématu pro zdroj dat DbConnection .Returns schema information for the data source of this DbConnection.

GetSchema(String)

Vrátí informace o schématu pro zdroj dat s DbConnection použitím zadaného řetězce pro název schématu.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

GetSchema(String, String[])

Vrátí informace o schématu pro zdroj dat s DbConnection použitím zadaného řetězce pro název schématu a zadaného pole řetězce pro hodnoty omezení.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

GetSchemaAsync(CancellationToken)

Toto je asynchronní verze GetSchema() .This is an asynchronous version of GetSchema(). Poskytovatelé by měli přepsat příslušnou implementací.Providers should override with an appropriate implementation. cancellationTokenMůže být volitelně akceptovatelné.The cancellationToken can optionally be honored. Výchozí implementace vyvolá synchronní GetSchema() volání a vrátí dokončenou úlohu.The default implementation invokes the synchronous GetSchema() call and returns a completed task. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušena cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Výjimky vyvolané nástrojem GetSchema() budou sděleny přes vrácenou vlastnost Exception úlohy.Exceptions thrown by GetSchema() will be communicated via the returned Task Exception property.

GetSchemaAsync(String, CancellationToken)

Toto je asynchronní verze GetSchema(String) .This is the asynchronous version of GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací.Providers should override with an appropriate implementation. cancellationTokenMůže být volitelně akceptovatelné.The cancellationToken can optionally be honored. Výchozí implementace vyvolá synchronní GetSchema(String) volání a vrátí dokončenou úlohu.The default implementation invokes the synchronous GetSchema(String) call and returns a completed task. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušena cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Výjimky vyvolané nástrojem GetSchema(String) budou sděleny přes vrácenou vlastnost Exception úlohy.Exceptions thrown by GetSchema(String) will be communicated via the returned Task Exception property.

GetSchemaAsync(String, String[], CancellationToken)

Toto je asynchronní verze GetSchema(String, String[]) .This is the asynchronous version of GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací.Providers should override with an appropriate implementation. cancellationTokenMůže být volitelně akceptovatelné.The cancellationToken can optionally be honored. Výchozí implementace vyvolá synchronní GetSchema(String, String[]) volání a vrátí dokončenou úlohu.The default implementation invokes the synchronous GetSchema(String, String[]) call and returns a completed task. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušena cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Výjimky vyvolané nástrojem GetSchema(String, String[]) budou sděleny přes vrácenou vlastnost Exception úlohy.Exceptions thrown by GetSchema(String, String[]) will be communicated via the returned Task Exception property.

GetService(Type)

Vrátí objekt, který představuje službu poskytnutou Component nebo podle jeho Container .Returns an object that represents a service provided by the Component or by its Container.

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

Získá Type aktuální instanci.Gets the Type of the current instance.

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

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří kopii aktuálního objektu bez podstruktury MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Zděděno od MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Vyvolá StateChange událost.Raises the StateChange event.

Open()

Při přepsání v odvozené třídě otevře připojení k databázi s nastavením určeným parametrem ConnectionString .When overridden in a derived class, opens a database connection with the settings specified by the ConnectionString.

OpenAsync()

Asynchronní verze nástroje Open() , která otevře připojení k databázi s nastavením určeným parametrem ConnectionString .An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) s CancellationToken. None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Toto je asynchronní verze Open() .This is the asynchronous version of Open(). Poskytovatelé by měli přepsat příslušnou implementací.Providers should override with an appropriate implementation. Token zrušení lze volitelně akceptovat.The cancellation token can optionally be honored.

Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu.The default implementation invokes the synchronous Open() call and returns a completed task. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Výjimky vyvolané příkazem Open budou sděleny přes vrácenou vlastnost Exception úlohy.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Nevolejte jiné metody a vlastnosti DbConnection objektu, dokud není vrácen dokončený úkol.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

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

Vrátí hodnotu String obsahující název Component , pokud existuje.Returns a String containing the name of the Component, if any. Tato metoda by neměla být přepsána.This method should not be overridden.

(Zděděno od Component)

Události

Disposed

Nastane, pokud je komponenta uvolněna voláním Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Zděděno od Component)
StateChange

Vyvolá se v případě, že dojde ke změně stavu připojení.Occurs when the state of the connection changes.

Explicitní implementace rozhraní

IDbConnection.BeginTransaction()

Zahájí databázovou transakci.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

Spustí databázovou transakci se zadanou úrovní izolace.Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand()

Vytvoří a vrátí DbCommand objekt, který je přidružený k aktuálnímu připojení.Creates and returns a DbCommand object that is associated with the current connection.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce await u úloh vrácených z asynchronního použití.Configures how awaits on the tasks returned from an async disposable are performed.

Platí pro