Поделиться через


DbConnection Класс

Определение

Определяет основное поведение подключений к базе данных и предоставляет базовый класс для подключений, относящихся к базе данных.

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
Наследование
DbConnection
Наследование
Производный
Реализации

Примечания для тех, кто реализует этот метод

При наследовании от DbConnectionнеобходимо переопределить следующие члены: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open()и StateChange. Также необходимо указать следующие свойства: ConnectionString, Database, DataSource, ServerVersionи State.

Конструкторы

DbConnection()

Инициализирует новый экземпляр класса DbConnection.

Свойства

CanCreateBatch

Возвращает значение, указывающее, поддерживает ли этот экземпляр DbConnection класс DbBatch.

CanRaiseEvents

Возвращает значение, указывающее, может ли компонент вызвать событие.

(Унаследовано от Component)
ConnectionString

При переопределении в производном классе получает или задает строку, используемую для открытия подключения.

ConnectionTimeout

Получает время ожидания (в секундах) при установке подключения перед завершением попытки и созданием ошибки.

Container

Возвращает IContainer, содержащую Component.

(Унаследовано от Component)
Database

При переопределении в производном классе получает имя текущей базы данных после открытия подключения или имя базы данных, указанное в строке подключения перед открытием подключения.

DataSource

При переопределении в производном классе получает имя сервера базы данных, к которому необходимо подключиться.

DbProviderFactory

Возвращает DbProviderFactory для этого DbConnection.

DesignMode

Возвращает значение, указывающее, находится ли Component в режиме конструктора.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, подключенных к этой Component.

(Унаследовано от Component)
ServerVersion

При переопределении в производном классе получает строку, представляющую версию сервера, к которому подключен объект.

Site

Возвращает или задает ISiteComponent.

(Унаследовано от Component)
State

Возвращает строку, описывающую состояние соединения.

Методы

BeginDbTransaction(IsolationLevel)

При переопределении в производном классе запускает транзакцию базы данных.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Асинхронно запускает транзакцию базы данных.

BeginTransaction()

Запускает транзакцию базы данных.

BeginTransaction(IsolationLevel)

Запускает транзакцию базы данных с указанным уровнем изоляции.

BeginTransactionAsync(CancellationToken)

Асинхронно начинает транзакцию базы данных.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Асинхронно начинает транзакцию базы данных.

ChangeDatabase(String)

При переопределении в производном классе изменяет текущую базу данных для открытого подключения.

ChangeDatabaseAsync(String, CancellationToken)

Асинхронно изменяет текущую базу данных для открытого подключения.

Close()

При переопределении в производном классе закрывает подключение к базе данных.

CloseAsync()

Асинхронно закрывает подключение к базе данных.

CreateBatch()

Возвращает новый экземпляр класса поставщика, реализующего класс DbBatch.

CreateCommand()

Создает и возвращает объект DbCommand, связанный с текущим подключением.

CreateDbBatch()

При переопределении в производном классе возвращает новый экземпляр класса поставщика, реализующего класс DbBatch.

CreateDbCommand()

При переопределении в производном классе создает и возвращает объект DbCommand, связанный с текущим подключением.

CreateObjRef(Type)

Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Dispose()

Выполняет определяемые приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов.

Dispose()

Освобождает все ресурсы, используемые Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые DbConnection, и при необходимости освобождает управляемые ресурсы.

Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые Component, и при необходимости освобождает управляемые ресурсы.

(Унаследовано от Component)
DisposeAsync()

Асинхронно разлагает объект подключения.

EnlistTransaction(Transaction)

Перечисление в указанной транзакции.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLifetimeService()
Устаревшие..

Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
GetSchema()

Возвращает сведения о схеме для источника данных этого DbConnection.

GetSchema(String)

Возвращает сведения о схеме для источника данных этого DbConnection с помощью указанной строки для имени схемы.

GetSchema(String, String[])

Возвращает сведения о схеме для источника данных этого DbConnection с помощью указанной строки для имени схемы и указанного массива строк для значений ограничений.

GetSchemaAsync(CancellationToken)

Это асинхронная версия GetSchema(). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetSchema() и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetSchema(), будут передаваться через возвращаемое свойство "Исключение задачи".

GetSchemaAsync(String, CancellationToken)

Это асинхронная версия GetSchema(String). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetSchema(String) и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetSchema(String), будут передаваться через возвращаемое свойство "Исключение задачи".

GetSchemaAsync(String, String[], CancellationToken)

Это асинхронная версия GetSchema(String, String[]). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetSchema(String, String[]) и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetSchema(String, String[]), будут передаваться через возвращаемое свойство "Исключение задачи".

GetService(Type)

Возвращает объект, представляющий службу, предоставляемую Component или Container.

(Унаследовано от Component)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
InitializeLifetimeService()
Устаревшие..

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неглубокую копию текущего объекта MarshalByRefObject.

(Унаследовано от MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Вызывает событие StateChange.

Open()

При переопределении в производном классе открывается соединение базы данных с параметрами, указанными в ConnectionString.

OpenAsync()

Асинхронная версия Open(), которая открывает подключение к базе данных с параметрами, указанными ConnectionString. Этот метод вызывает виртуальный метод OpenAsync(CancellationToken) с помощью CancellationToken.None.

OpenAsync(CancellationToken)

Это асинхронная версия Open(). Поставщики должны переопределить соответствующую реализацию. Маркер отмены можно при необходимости учитывать.

Реализация по умолчанию вызывает синхронный вызов Open() и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу, если передана уже отмененная отменаToken. Исключения, создаваемые Open, будут передаваться через возвращаемое свойство "Исключение задачи".

Не вызывайте другие методы и свойства объекта DbConnection до завершения возвращаемой задачи.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
ToString()

Возвращает String, содержащую имя Component, если таковой имеется. Этот метод не должен быть переопределен.

(Унаследовано от Component)

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().

(Унаследовано от Component)
StateChange

Происходит при изменении состояния подключения.

Явные реализации интерфейса

IDbConnection.BeginTransaction()

Начинает транзакцию базы данных.

IDbConnection.BeginTransaction(IsolationLevel)

Начинает транзакцию базы данных с указанным уровнем изоляции.

IDbConnection.CreateCommand()

Создает и возвращает объект DbCommand, связанный с текущим подключением.

Методы расширения

ConfigureAwait(IAsyncDisposable, Boolean)

Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.

Применяется к

См. также раздел

  • dbProviderFactories (ADO.NET)
  • обзора ADO.NET