Класс 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) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

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

SqlCeDataAdapter

SqlCeCommand