DbConnection Klasa

Definicja

Definiuje podstawowe zachowanie połączeń z bazą danych i udostępnia klasę bazową dla połączeń specyficznych dla bazy danych.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
Dziedziczenie
DbConnection
Dziedziczenie
Pochodne
Implementuje

Uwagi dotyczące implementowania

W przypadku dziedziczenia z DbConnection , należy zastąpić następujące elementy członkowskie:,,,, Close() BeginDbTransaction(IsolationLevel) ChangeDatabase(String) CreateDbCommand() Open() i StateChange .When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. Należy również podać następujące właściwości: ConnectionString ,,, Database DataSource ServerVersion i State .You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Konstruktory

DbConnection()

Inicjuje nowe wystąpienie klasy DbConnection.Initializes a new instance of the DbConnection class.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
ConnectionString

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia ciąg używany do otwierania połączenia.When overridden in a derived class, gets or sets the string used to open the connection.

ConnectionTimeout

Pobiera czas oczekiwania (w sekundach) podczas ustanawiania połączenia przed zakończeniem próby i wygenerowaniem błędu.Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

Pobiera IContainer , który zawiera Component .Gets the IContainer that contains the Component.

(Odziedziczone po Component)
Database

Gdy jest zastępowany w klasie pochodnej, pobiera nazwę bieżącej bazy danych po otwarciu połączenia lub nazwę bazy danych określoną w parametrach połączenia przed otwarciem połączenia.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

Gdy jest zastępowany w klasie pochodnej, pobiera nazwę serwera bazy danych, z którym ma zostać nawiązane połączenie.When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory

Pobiera DbProviderFactory dla tego elementu DbConnection .Gets the DbProviderFactory for this DbConnection.

DesignMode

Pobiera wartość wskazującą, czy Component jest aktualnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego elementu Component .Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
ServerVersion

Gdy jest zastępowany w klasie pochodnej, pobiera ciąg, który reprezentuje wersję serwera, z którym jest połączony obiekt.When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site

Pobiera lub ustawia wartość ISite Component .Gets or sets the ISite of the Component.

(Odziedziczone po Component)
State

Pobiera ciąg opisujący stan połączenia.Gets a string that describes the state of the connection.

Metody

BeginDbTransaction(IsolationLevel)

Gdy jest zastępowany w klasie pochodnej, uruchamia transakcję bazy danych.When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie uruchamia transakcję bazy danych.Asynchronously starts a database transaction.

BeginTransaction()

Uruchamia transakcję bazy danych.Starts a database transaction.

BeginTransaction(IsolationLevel)

Uruchamia transakcję bazy danych o określonym poziomie izolacji.Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.Asynchronously begins a database transaction.

ChangeDatabase(String)

Gdy jest zastępowany w klasie pochodnej, zmienia bieżącą bazę danych dla otwartego połączenia.When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken)

Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia.Asynchronously changes the current database for an open connection.

Close()

Gdy jest zastępowany w klasie pochodnej, zamyka połączenie z bazą danych.When overridden in a derived class, closes the connection to the database.

CloseAsync()

Asynchronicznie zamyka połączenie z bazą danych.Asynchronously closes the connection to the database.

CreateCommand()

Tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem.Creates and returns a DbCommand object associated with the current connection.

CreateDbCommand()

Gdy jest zastępowany w klasie pochodnej, tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbConnection i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the DbConnection and optionally releases the managed resources.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie nakłada obiekt połączenia.Asynchronously diposes the connection object.

EnlistTransaction(Transaction)

Rejestracja w określonej transakcji.Enlists in the specified transaction.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetSchema()

Zwraca informacje o schemacie dla źródła danych DbConnection .Returns schema information for the data source of this DbConnection.

GetSchema(String)

Zwraca informacje o schemacie dla źródła danych, DbConnection używając określonego ciągu dla nazwy schematu.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

GetSchema(String, String[])

Zwraca informacje o schemacie dla źródła danych, DbConnection używając określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.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)

Jest to asynchroniczna wersja programu GetSchema() .This is an asynchronous version of GetSchema(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetSchema() wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetSchema() call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetSchema() program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetSchema() will be communicated via the returned Task Exception property.

GetSchemaAsync(String, CancellationToken)

Jest to asynchroniczna wersja programu GetSchema(String) .This is the asynchronous version of GetSchema(String). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetSchema(String) wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetSchema(String) call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetSchema(String) program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetSchema(String) will be communicated via the returned Task Exception property.

GetSchemaAsync(String, String[], CancellationToken)

Jest to asynchroniczna wersja programu GetSchema(String, String[]) .This is the asynchronous version of GetSchema(String, String[]). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetSchema(String, String[]) wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetSchema(String, String[]) call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetSchema(String, String[]) program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetSchema(String, String[]) will be communicated via the returned Task Exception property.

GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub przez Container .Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Podnosi StateChange zdarzenie.Raises the StateChange event.

Open()

Gdy jest zastępowany w klasie pochodnej, program otwiera połączenie z bazą danych z ustawieniami określonymi przez ConnectionString .When overridden in a derived class, opens a database connection with the settings specified by the ConnectionString.

OpenAsync()

Wersja asynchroniczna programu Open() , która otwiera połączenie z bazą danych z ustawieniami określonymi przez ConnectionString .An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Ta metoda wywołuje metodę wirtualną OpenAsync(CancellationToken) z CancellationToken. None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Jest to asynchroniczna wersja programu Open() .This is the asynchronous version of Open(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania można opcjonalnie przyjąć.The cancellation token can optionally be honored.

Implementacja domyślna wywołuje Open() wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous Open() call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone już anulowane cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez otwarcie będą przekazywane za pośrednictwem Właściwości zwróconego wyjątku zadania.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości DbConnection obiektu do momentu zakończenia zwracanego zadania.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
ToString()

Zwraca wartość String zawierającą nazwę Component (jeśli istnieje).Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)
StateChange

Występuje, gdy zmienia się stan połączenia.Occurs when the state of the connection changes.

Jawne implementacje interfejsu

IDbConnection.BeginTransaction()

Rozpoczyna transakcję bazy danych.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

Rozpoczyna transakcję bazy danych o określonym poziomie izolacji.Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand()

Tworzy i zwraca DbCommand obiekt, który jest skojarzony z bieżącym połączeniem.Creates and returns a DbCommand object that is associated with the current connection.

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Określa, jak oczekują oczekiwania na zadania zwracane z asynchronicznej operacji tworzenia.Configures how awaits on the tasks returned from an async disposable are performed.

Dotyczy

Zobacz też