DbConnection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.Common

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Źródło:: DbConnection.cs

Źródło:: DbConnection.cs

Źródło:: DbConnection.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Definiuje podstawowe zachowanie Połączenia z bazą 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: Object
DbConnection

Dziedziczenie: Object

MarshalByRefObject

Component
DbConnection

Pochodne: System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.OracleClient.OracleConnection

System.Data.SqlClient.SqlConnection

Implementuje: IDisposable IDbConnection IAsyncDisposable

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, , Database DataSource, 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 w klasie pochodnej pobiera ciąg reprezentujący wersję serwera, z którym jest połączony obiekt.
Site	Pobiera lub ustawia wartość ISite .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()	Przestarzałe. 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ą. Opcjonalnie `cancellationToken` 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 zostało już anulowane `cancellationToken`. Wyjątki zgłaszane przez GetSchema(String, String[]) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. 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()	Wersja asynchroniczna programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez .ConnectionString Ta metoda wywołuje metodę OpenAsync(CancellationToken) wirtualną z elementem CancellationToken.None.
OpenAsync(CancellationToken)	Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie uhonorować. 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 odwołanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek 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 zmienia się stan połączenia.

Jawne implementacje interfejsu

IDbConnection.BeginTransaction()	Rozpoczyna transakcję bazy danych.
IDbConnection.BeginTransaction(IsolationLevel)	Rozpoczyna transakcję bazy danych o określonym poziomie 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