Класс SqlCeConnection
Представляет открытое соединение с источником данных SQL Server Compact.
Иерархия наследования
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbConnection
System.Data.SqlServerCe.SqlCeConnection
Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)
Синтаксис
'Декларация
Public NotInheritable Class SqlCeConnection _
Inherits DbConnection
'Применение
Dim instance As SqlCeConnection
public sealed class SqlCeConnection : DbConnection
public ref class SqlCeConnection sealed : public DbConnection
[<SealedAttribute>]
type SqlCeConnection =
class
inherit DbConnection
end
public final class SqlCeConnection extends DbConnection
Тип SqlCeConnection обеспечивает доступ к следующим элементам.
Конструкторы
Имя | Описание | |
---|---|---|
SqlCeConnection() | Инициализация нового экземпляра класса SqlCeConnection. | |
SqlCeConnection(String) | Инициализирует новый экземпляр класса SqlCeConnection с указанной строкой подключения. |
В начало
Свойства
Имя | Описание | |
---|---|---|
CanRaiseEvents | (унаследовано из Component) | |
ConnectionString | Возвращает или задает строку, используемую для открытия базы данных. (Переопределяет DbConnection.ConnectionString.) | |
ConnectionTimeout | Возвращает значение времени, в течение которого происходит ожидание при попытке установления соединения, прежде чем эта попытка будет завершена с выдачей ошибки. (Переопределяет DbConnection.ConnectionTimeout.) | |
Container | (унаследовано из Component) | |
Database | Возвращает имя текущей базы данных или базы данных, доступной после открытия соединения. (Переопределяет DbConnection.Database.) | |
DatabaseIdentifier | Возвращает уникальный идентификатор текущей базы данных при синхронизации. | |
DataSource | Возвращает имя файла источника данных. (Переопределяет DbConnection.DataSource.) | |
DbProviderFactory | (унаследовано из DbConnection) | |
DesignMode | (унаследовано из Component) | |
Events | (унаследовано из Component) | |
ServerVersion | Возвращает номер версии базы данных в виде строки. (Переопределяет DbConnection.ServerVersion.) | |
Site | (унаследовано из Component) | |
State | Возвращает текущее состояние соединения. (Переопределяет DbConnection.State.) |
В начало
Методы
Имя | Описание | |
---|---|---|
BeginDbTransaction | (унаследовано из DbConnection) | |
BeginTransaction() | Начинает транзакцию базы данных. | |
BeginTransaction(IsolationLevel) | Начинает транзакцию базы данных с текущим значением IsolationLevel. | |
ChangeDatabase | Осуществляет смену текущей базы данных для открытого соединения SqlCeConnection. (Переопределяет DbConnection.ChangeDatabase(String).) | |
Close | Закрывает соединение с источником данных. Этот метод является предпочтительным для закрытия любого открытого соединения. (Переопределяет DbConnection.Close().) | |
CreateCommand | Создает и возвращает объект SqlCeCommand, связанный с SqlCeConnection. | |
CreateDbCommand | (унаследовано из DbConnection) | |
CreateObjRef | (унаследовано из MarshalByRefObject) | |
Dispose() | Освобождает ресурсы, используемые текущим экземпляром класса SqlCeConnection. | |
Dispose(Boolean) | (унаследовано из Component) | |
EnlistTransaction(Transaction) | (унаследовано из DbConnection) | |
EnlistTransaction(Transaction) | Вставляется в указанную транзакцию Transaction. | |
Equals | (унаследовано из Object) | |
Finalize | (унаследовано из Component) | |
GetDatabaseInfo | Возвращает набор пар «ключ-значение», содержащий сведения о локали, режиме шифрования и учете регистра в подключенной базе данных. | |
GetHashCode | (унаследовано из Object) | |
GetLifetimeService | (унаследовано из MarshalByRefObject) | |
GetSchema() | Возвращает сведения о схеме для источника данных данного подключения SqlCeConnection. (Переопределяет DbConnection.GetSchema().) | |
GetSchema(String) | Возвращает сведения схемы для источника данных данного подключения SqlCeConnection с помощью строки для имени схемы. (Переопределяет DbConnection.GetSchema(String).) | |
GetSchema(String, array<String[]) | Возвращает сведения схемы для источника данных данного подключения SqlCeConnection, используя указанную строки для имени схемы и массив строк для ограничивающих значений. (Переопределяет DbConnection.GetSchema(String, array<String[]).) | |
GetService | (унаследовано из Component) | |
GetType | (унаследовано из Object) | |
InitializeLifetimeService | (унаследовано из MarshalByRefObject) | |
MemberwiseClone() | (унаследовано из Object) | |
MemberwiseClone(Boolean) | (унаследовано из MarshalByRefObject) | |
OnStateChange | (унаследовано из DbConnection) | |
Open | Открывает подключение к базе данных на основе параметров, заданных в строке соединения ConnectionString. (Переопределяет DbConnection.Open().) | |
ToString | (унаследовано из Component) |
В начало
События
Имя | Описание | |
---|---|---|
Disposed | (унаследовано из Component) | |
FlushFailure | Возникает в том случае, когда фоновая запись данных завершается ошибкой. | |
InfoMessage | Возникает момент отправки предупреждения или информационного сообщения поставщиком данных .NET Compact Framework для SQL Server. | |
StateChange | Возникает при изменении состояния соединения. (Переопределяет DbConnection.StateChange.) |
В начало
Явные реализации интерфейса
Имя | Описание | |
---|---|---|
IDbConnection.BeginTransaction() | (унаследовано из DbConnection) | |
IDbConnection.BeginTransaction(IsolationLevel) | (унаследовано из DbConnection) | |
IDbConnection.CreateCommand | (унаследовано из DbConnection) |
В начало
Замечания
Объект SqlCeConnection представляет уникальное соединение с источником данных. При создании экземпляра SqlCeConnection всем свойствам присваиваются их начальные значения. Список этих значений см. в конструкторе SqlCeConnection.
Если соединение SqlCeConnection выходит из области видимости, то его закрытие не производится. Соединение необходимо закрыть явно, вызвав метод Close или Dispose.
SQL Server Compact поддерживает одновременно несколько соединений, а также выполнение на одном соединении нескольких команд. Это означает, для одного соединения может быть несколько экземпляров объекта SqlCeDataReader. В этом заключается отличие от System.Data.SqlClient.
Если возникло неустранимое исключение SqlCeException во время вызова метода, выполняющего SqlCeCommand, соединение SqlCeConnection может быть закрыто. Его можно открыть заново и продолжить работу.
Примеры
В следующем примере производится создание объектов SqlCeCommand и SqlCeConnection. Соединение SqlCeConnection открыто и задано в свойстве Connection объекта SqlCeCommand. После этого в примере вызывается метод ExecuteNonQuery, после чего соединение закрывается.
Dim conn As SqlCeConnection = Nothing
Try
conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
conn.Open()
Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"
cmd.ExecuteNonQuery()
Finally
conn.Close()
End Try
SqlCeConnection conn = null;
try
{
conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
conn.Open();
SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";
cmd.ExecuteNonQuery();
}
finally
{
conn.Close();
}
Безопасность многопоточности
Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.