DbConnection Klasa

Definicja

Definiuje podstawowe zachowanie połączeń bazy danych i udostępnia klasę bazową dla połączeń specyficznych dla bazy danych.

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

Podczas dziedziczenia z DbConnectionelementu należy zastąpić następujące elementy członkowskie: Close(), , BeginDbTransaction(IsolationLevel)ChangeDatabase(String), CreateDbCommand()Open()i StateChange. Należy również podać następujące właściwości: ConnectionString, , DatabaseDataSource, ServerVersioni State.

Konstruktory

DbConnection()

Inicjuje nowe wystąpienie klasy DbConnection.

Właściwości

CanCreateBatch

Pobiera wartość wskazującą, czy to DbConnection wystąpienie obsługuje klasę DbBatch .

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
ConnectionString

Po zastąpieniu w klasie pochodnej pobiera lub ustawia parametry użyte do otwarcia połączenia.

ConnectionTimeout

Pobiera czas oczekiwania (w sekundach) podczas nawiązywania połączenia przed zakończeniem próby i wygenerowaniem błędu.

Container

Pobiera element IContainer zawierający element Component.

(Odziedziczone po Component)
Database

Po zastąpieniu 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.

DataSource

Po przesłonięciu w klasie pochodnej pobiera nazwę serwera bazy danych, z którym ma być nawiązywane połączenie.

DbProviderFactory

Pobiera element DbProviderFactory dla tego DbConnectionpliku .

DesignMode

Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu .

(Odziedziczone po Component)
ServerVersion

Po zastąpieniu klasy pochodnej pobiera ciąg reprezentujący wersję serwera, z którym jest połączony obiekt.

Site

Pobiera lub ustawia ISite element .Component

(Odziedziczone po Component)
State

Pobiera parametry opisujące stan połączenia.

Metody

BeginDbTransaction(IsolationLevel)

Po zastąpieniu w klasie pochodnej uruchamia transakcję bazy danych.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie uruchamia transakcję bazy danych.

BeginTransaction()

Uruchamia transakcję bazy danych.

BeginTransaction(IsolationLevel)

Uruchamia transakcję bazy danych z określonym poziomem izolacji.

BeginTransactionAsync(CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Asynchronicznie rozpoczyna transakcję bazy danych.

ChangeDatabase(String)

Po zastąpieniu w klasie pochodnej zmienia bieżącą bazę danych dla otwartego połączenia.

ChangeDatabaseAsync(String, CancellationToken)

Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia.

Close()

Po zastąpieniu w klasie pochodnej program zamyka połączenie z bazą danych.

CloseAsync()

Asynchronicznie zamyka połączenie z bazą danych.

CreateBatch()

Zwraca nowe wystąpienie klasy dostawcy, która implementuje klasę DbBatch .

CreateCommand()

Tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem.

CreateDbBatch()

Po przesłonięciu w klasie pochodnej zwraca nowe wystąpienie klasy dostawcy, która implementuje klasę DbBatch .

CreateDbCommand()

Po zastąpieniu w klasie pochodnej program tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem.

CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
Dispose()

Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.

Dispose()

Zwalnia wszelkie zasoby używane przez element Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbConnection i opcjonalnie zwalnia zasoby zarządzane.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie modyfikuje obiekt połączenia.

EnlistTransaction(Transaction)

Enlists w określonej transakcji.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetSchema()

Zwraca informacje o schemacie dla źródła danych tego DbConnectionelementu .

GetSchema(String)

Zwraca informacje o schemacie dla źródła DbConnection danych przy użyciu określonego ciągu dla nazwy schematu.

GetSchema(String, String[])

Zwraca informacje o schemacie dla źródła DbConnection danych przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.

GetSchemaAsync(CancellationToken)

Jest to asynchroniczna wersja programu GetSchema(). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchema() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

GetSchemaAsync(String, CancellationToken)

Jest to asynchroniczna wersja programu GetSchema(String). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema(String) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchema(String) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

GetSchemaAsync(String, String[], CancellationToken)

Jest to asynchroniczna wersja programu GetSchema(String, String[]). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken Opcjonalnie można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchema(String, String[]) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane cancellationToken. Wyjątki zgłoszone przez GetSchema(String, String[]) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania.

GetService(Type)

Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container.

(Odziedziczone po Component)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

StateChange Zgłasza zdarzenie.

Open()

Po zastąpieniu w klasie pochodnej otwiera połączenie bazy danych z ustawieniami określonymi przez ConnectionString.

OpenAsync()

Asynchroniczna wersja programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez ConnectionStringelement . Ta metoda wywołuje metodę wirtualną z elementem OpenAsync(CancellationToken) CancellationToken.None.

OpenAsync(CancellationToken)

Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie honorować.

Domyślna implementacja wywołuje wywołanie synchroniczne Open() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane anulowanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku zadania.

Nie należy wywoływać innych metod i właściwości DbConnection obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
ToString()

Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)
StateChange

Występuje, gdy stan połączenia ulegnie zmianie.

Jawne implementacje interfejsu

IDbConnection.BeginTransaction()

Rozpoczyna transakcję bazy danych.

IDbConnection.BeginTransaction(IsolationLevel)

Rozpoczyna transakcję bazy danych z określonym poziomem izolacji.

IDbConnection.CreateCommand()

Tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem.

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje sposób oczekiwania na zadania zwracane z jednorazowego użytku asynchronicznego.

Dotyczy

Zobacz też