DbManager - класс

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

Иерархия наследования

SystemObject
Tessa.Platform.DataDbManager

Пространство имён: Tessa.Platform.Data
Сборка: Tessa (в Tessa.dll) Версия: 3.5.0.19

Синтаксис

C++

Копировать

public class DbManager : IAsyncDisposable

Public Class DbManager
	Implements IAsyncDisposable

public ref class DbManager : IAsyncDisposable

type DbManager =  
    class
        interface IAsyncDisposable
    end

Тип DbManager предоставляет следующие члены.

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

	Имя	Описание
	DbManager	Устарело. Создаёт объект со строкой подключения по умолчанию из файла конфигурации app.json.
	DbManager(DataConnection)	Создаёт объект с указанием подключения к базе данных DataConnection. Указанное подключение будет освобождено при вызове метода DisposeAsync создаваемого объекта.
	DbManager(String)	Устарело. Создаёт объект по строке подключения из файла конфигурации app.json с заданным именем строки подключения.
	DbManager(IDataProvider, IDbConnection)	Создаёт объект по заданному провайдеру и объекту подключения к базе данных.
	DbManager(IDataProvider, IDbTransaction)	Создаёт объект по заданному провайдеру и объекту транзакции, выполняемой для базы данных.
	DbManager(IDataProvider, String)	Создаёт объект по заданному провайдеру и тексту строки подключения.
	DbManager(String, String)	Создаёт объект по заданному провайдеру и тексту строки подключения.

В начало страницы

Свойства

	Имя	Описание
	Command	Информация по последней выполненной команде на базе данных. При первом обращении создаётся "пустая" команда, не равная null.
	CommandInfo	Информация по последней команде, указанной методами SetCommand, или null, если такая команда отсутствует.
	CommandInfoTimeout	Таймаут в секундах, заданный методами SetCommandTimeout(Int32) или WithoutTimeout для последней команды, или null, если для последней команды используется таймаут по умолчанию.
	CommandTimeout	Таймаут команд, создаваемых на соединении DataConnection. Рекомендуется установить либо сразу после создания объекта для переопределения таймаута всех выполняемых команд, либо использовать методы SetCommandTimeout(Int32) и WithoutTimeout для определения таймаутов отдельно указанных команд, при этом таймаут для всех команд указывается в строке подключения (например, в конфигурационном файле).
	Connection	Соединение с базой данных или null, если соединение не было установлено.
	DataConnection	Объект соединения с базой данных, посредством которого выполняются любые действия в текущем объекте.
	DataProvider	Провайдер, обеспечивающий соединение с СУБД.
	InlineParameters	Признак InlineParameters для команд, выполняемых на текущем соединении DataConnection. Может быть получен или установлен.
	IsDisposed	Признак того, что ресурсы объекта были освобождены.
	IsMarsEnabled	Признак того, что для текущего соединения DataConnection доступен MARS (Multiple Active Result Sets). Может быть получен или установлен.
	LastQuery	Текст последнего выполненного запроса на базе данных. Устанавливается после вызова методов Execute***.
	MappingSchema	Схема соответствия типов и объектов СУБД с абстрактно заданными типами и объектами, такими как DataType и DataParameter.
	Transaction	Транзакция, открытая в базе данных, обычно методами BeginTransaction, или null, если транзакция не была открыта.

В начало страницы

Методы

	Имя	Описание
	BeginTransactionAsync(CancellationToken)	Асинхронно открывает транзакцию с уровнем изоляции по умолчанию.
	BeginTransactionAsync(IsolationLevel, CancellationToken)	Асинхронно открывает транзакцию с указанным уровнем изоляции.
	CancelCommand	Удаляет информацию по предыдущей добавленной команде без вызова SetCommand для указания новой команды. Используйте в том случае, если был вызван метод SetCommand (или аналогичный), но его выполнение было отменено.
	CloseAsync	Асинхронно закрывает соединение и освобождает занятые ресурсы, но позволяет продолжить использовать текущий объект, в отличие от метода DisposeAsync.
	CommandHasData	Возвращает признак того, что команда задана и содержит непустую строку.
	CommitTransactionAsync	Асинхронно выполняет коммит транзакции с уровнем изоляции по умолчанию.
	DisposeAsync	Освобождает ресурсы, занимаемые объектом.
	DisposeAsync(Boolean)	Освобождает ресурсы, занимаемые объектом.
	EnsureConnectionAsync	Асинхронно открывает соединение, если оно ещё не открыто.
	Equals	Determines whether the specified object is equal to the current object. (Унаследован от Object.)
	ExecuteAsyncT	Асинхронно выполняет SQL-команду и возвращает объект заданного типа. Объект может быть скалярным (простым типом) или нескалярным (классом или структурой).
	ExecuteListAsyncT	Асинхронно выполняет SQL-команду и возвращает список объектов. Объект может быть скалярным (простым типом) или нескалярным (классом или структурой).
	ExecuteNonQueryAsync	Асинхронно выполняет запрос, не возвращающий ResultSet, и возвращает количество строк, затронутых при выполнении. Например, количество вставленных строк для INSERT, изменённых для UPDATE или удалённых для DELETE.
	ExecuteReaderAsync(CancellationToken)	Создаёт объект для чтения данных по выполняемой SQL-команде.
	ExecuteReaderAsync(CommandBehavior, CancellationToken)	Создаёт объект для чтения данных по выполняемой SQL-команде с указанием поведения выполняемой команды. Выделение ресурсов при создании объекта выполняется асинхронно.
	ExecuteSetXactAbortOnAsync	Выполняет команду SET XACT_ABORT ON, которая устанавливает автоматический откат транзакции при ошибке в процессе выполнения SQL.
	ExecuteStreamAsync	Возвращает поток с данными, полученный из запроса по установленной команде. Используйте в случае, когда запрос возвращает одну строку, в которой присутствует varbinary колонка с заданным индексом. Если запрос не вернул данных, то возвращает Null, но не возвращает null. Поток открывается асинхронно.
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Унаследован от Object.)
	GetCommandDataParameters	Возвращает массив параметров текущей команды CommandInfo или пустой массив, если текущая команда отсутствует.
	GetCommandText	Возвращает текст текущей команды CommandInfo или null, если текущая команда отсутствует.
	GetDataProvider	Возвращает провайдер для заданных имени провайдера для строки подключения и текста строки подключения.
	GetDbParameter	Возвращает объект IDbDataParameter, готовый к использованию в SQL-командах, полученный для заданного параметра DataParameter. Внимание! Выполнение метода может синхронно открыть соединение с СУБД, если оно ещё не открыто. Вызовите ожидание на методе EnsureConnectionAsync(CancellationToken), чтобы не открывать соединение синхронно, если оно не открыто.
	GetHashCode	Serves as the default hash function. (Унаследован от Object.)
	GetSqlServerDataProvider	Возвращает рекомендуемый провайдер IDataProvider для использования совместно с MS SQL Server.
	GetType	Gets the Type of the current instance. (Унаследован от Object.)
	InputOutputParameter	Создаёт смешанный (и передаваемый в запрос, и возвращаемый из запроса) параметр с указанием имени и значения. Тип данных определяется автоматически по значению. Другие свойства параметра можно задать через свойств возвращённого объекта.
	InputParameter	Создаёт входящий (передаваемый в запрос) параметр с указанием имени и значения. Тип данных определяется автоматически по значению. Другие свойства параметра можно задать через свойств возвращённого объекта.
	LogCommand	Записывает в логгер с именем SqlQueries SQL-выражение команды, которая задана в объекте DbManager. Если объект не содержит команду, то записи в лог не происходит.
	MemberwiseClone	Creates a shallow copy of the current Object. (Унаследован от Object.)
	OnDisposedAsync	Действие, выполняемое при освобождении ресурсов, занимаемых объектом, в методе DisposeAsync. В реализации по умолчанию вызывает событие Disposed.
	OutputParameter(String, Object)	Создаёт исходящий (возвращаемый из запроса) параметр с указанием имени и значения. Тип данных определяется автоматически по значению. Другие свойства параметра можно задать через свойств возвращённого объекта.
	OutputParameter(String, Object, DataType)	Создаёт исходящий (возвращаемый из запроса) параметр с указанием имени, значения и типа данных из перечисления DataType. Другие свойства параметра можно задать через свойств возвращённого объекта.
	OutputParameter(String, Object, DataType, Int32)	Создаёт исходящий (возвращаемый из запроса) параметр с указанием имени, значения, типа данных из перечисления DataType и размера. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(String)	Создаёт параметр с указанием имени. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(String, DataType)	Создаёт параметр с указанием имени и типа данных из перечисления DataType. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(String, Object)	Создаёт параметр с указанием имени и значения. Тип данных определяется автоматически по значению. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(ParameterDirection, String, DataType)	Создаёт параметр с указанием направления использования, имени и типа данных из перечисления DataType. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(ParameterDirection, String, Object)	Создаёт параметр с указанием направления использования, имени и значения. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(String, DataType, Int32)	Создаёт параметр с указанием имени, типа данных из перечисления DataType и размера. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(String, Object, DataType)	Создаёт параметр с указанием имени, значения и типа данных из перечисления DataType. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(ParameterDirection, String, DataType, Int32)	Создаёт параметр с указанием направления использования, имени, типа данных из перечисления DataType и размера. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(ParameterDirection, String, Object, DataType)	Создаёт параметр с указанием направления использования, имени, значения и типа данных из перечисления DataType. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(String, Object, DataType, Int32)	Создаёт параметр с указанием имени, значения, типа данных из перечисления DataType и размера. Другие свойства параметра можно задать через свойств возвращённого объекта.
	Parameter(ParameterDirection, String, Object, DataType, Int32)	Создаёт параметр с указанием направления использования, имени, значения, типа данных из перечисления DataType и размера. Другие свойства параметра можно задать через свойств возвращённого объекта.
	ResolveParameterType	Определяет тип параметра в зависимости от маппинга для текущего соединения. Заменяет DataType на тип, вычисленный для значения.
	ResolveTypeAndRecreateParameterIfRequired	Возвращает параметр, у которого тип данных DataType определён из значения объекта. Это либо ссылка на параметр parameter, либо новый объект DataParameter с изменённым DataType. Переданный объект parameter не изменяется.
	RollbackTransactionAsync	Асинхронно выполняет откат транзакции с уровнем изоляции по умолчанию.
	SetCommand(String)	Подготавливает команду для выполнения с указанием SQL-выражения команды.
	SetCommand(CommandType, String)	Подготавливает команду для выполнения с указанием типа команды и её SQL-выражения.
	SetCommand(String, DataParameter)	Подготавливает команду для выполнения с указанием SQL-выражения команды и её параметров.
	SetCommand(CommandType, String, DataParameter)	Подготавливает команду для выполнения с указанием типа команды, её SQL-выражения и параметров.
	SetCommandTimeout	Устанавливает таймаут для последней заданной команды.
	SetSpCommand(String)	Подготавливает команду для выполнения хранимой процедуры с указанием её имени.
	SetSpCommand(String, DataParameter)	Подготавливает команду для выполнения хранимой процедуры с указанием её имени и параметров.
	ToString	Returns a string that represents the current object. (Унаследован от Object.)
	WithoutTimeout	Устанавливает неограниченный таймаут для последней заданной команды.

В начало страницы

События

	Имя	Описание
	Disposed	Событие, выполняемое при освобождении ресурсов, занимаемых объектом, в методе DisposeAsync. В обработчиках событий возможно использование асинхронности посредством using (e.Defer()) { await ... }.

В начало страницы

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

	Имя	Описание
	Get	(Определяется ComHelper.)
	GetDbms	(Определяется Extensions.)
	InternalMarkerCanvas	Возвращает маркер аннотации (Определяется AnnotationInternalsAccessor.)
	Invoke	(Определяется ComHelper.)
	Set	(Определяется ComHelper.)

В начало страницы

Заметки

Наследники класса могут добавлять или переопределять методы.

См. также

Ссылки

Tessa.Platform.Data - пространство имён