DbConnection Класс

Определение

Пространство имен:: System.Data.Common

Сборка:: System.Data.Common.dll

Сборки:: netstandard.dll, System.Data.Common.dll

Сборка:: System.Data.dll

Сборка:: netstandard.dll

Исходный код:: DbConnection.cs

Исходный код:: DbConnection.cs

Исходный код:: DbConnection.cs

Исходный код:: DbConnection.cs

Исходный код:: DbConnection.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

Наследование: Object
DbConnection

Наследование: Object

MarshalByRefObject

Component
DbConnection

Производный: System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.OracleClient.OracleConnection

System.Data.SqlClient.SqlConnection

Реализации: IDisposable IDbConnection IAsyncDisposable

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

При наследовании 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	Возвращает или задает ISite объект Component. (Унаследовано от 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, String[])	Возвращает сведения о схеме для источника данных, DbConnection используя указанную строку для имени схемы и указанный массив строк для значений ограничений.
GetSchema(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)	Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.

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

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

Обратная связь

Были ли сведения на этой странице полезными?