SqlCeConnection Class

Представляет открытое соединение с источником данных SQL Server Compact 3.5.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в system.data.sqlserverce.dll)

Синтаксис

'Декларация
Public NotInheritable Class SqlCeConnection
    Inherits DbConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

public final class SqlCeConnection extends DbConnection

public final class SqlCeConnection extends DbConnection

Замечания

Объект SqlCeConnection представляет уникальное соединение с источником данных. При создании экземпляра SqlCeConnection всем свойствам присваиваются их начальные значения. Список этих значений см. в конструкторе SqlCeConnection.

Если соединение SqlCeConnection выходит из области видимости, то его закрытие не производится. Соединение необходимо закрыть явно, вызвав метод Close или Dispose.

SQL Server Compact 3.5 поддерживает одновременно несколько соединений, а также выполнение на одном соединении нескольких команд. Это означает, для одного соединения может быть несколько экземпляров объекта SqlCeDataReader. В этом заключается отличие от System.Data.SqlClient.

Если возникло неисправимое исключение SqlCeException во время вызова метода, выполняющего SqlCeCommand, соединение SqlCeConnection может быть закрыто. Его можно открыть заново и продолжить работу.

В настоящее время SQL Server Compact 3.5 не оптимизирован для работы в качестве базы данных для веб-узлов. По умолчанию SQL Server Compact 3.5 блокирует соединения от приложений, работающих через ASP.NET. SQL Server Compact 3.5 оптимизирован для работы с приложениями в качестве внедренной базы данных. Чтобы SQL Server Compact 3.5 мог использоваться в качестве базы данных для веб-узлов, необходима поддержка нескольких пользователей и одновременного изменения данных. Это может привести к снижению производительности. Поэтому такое применение не поддерживается. Другие выпуски SQL Server (в том числе SQL Server Express) оптимизированы для использования в качестве баз данных для веб-узлов.

Совместное применение SQL Server Compact 3.5 и ASP.NET поддерживается для тех случаев, когда ASP.NET используется для создания баз данных SQL Server Compact 3.5 для синхронизации. Следующий код позволяет изменить поведение SQL Server Compact 3.5 по умолчанию для работы в ASP.NET.

AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)

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

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlServerCe.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) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeConnection Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeCommand Class