SqlCeCommand.Connection Property

Статья
01/14/2011

Возвращает или задает соединение SqlCeConnection, используемое этим экземпляром SqlCeCommand.

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

Синтаксис

'Декларация
Public Property Connection As SqlCeConnection

public SqlCeConnection Connection { get; set; }

public:
property SqlCeConnection^ Connection {
    SqlCeConnection^ get ();
    void set (SqlCeConnection^ value);
}

/** @property */
public SqlCeConnection get_Connection ()

/** @property */
public void set_Connection (SqlCeConnection value)

public function get Connection () : SqlCeConnection

public function set Connection (value : SqlCeConnection)

Значение свойства

Соединение с источником данных. Значением по умолчанию является null.

Исключения

Тип исключения	Условие
InvalidOperationException	Свойство Connection изменилось во время выполнения транзакции.

Замечания

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

Если текущее соединение выполняет операции Execute или Fetch, то установка свойств Connection, CommandType и CommandText невозможна.

Если задать свойство Connection во время выполнения транзакции, а значение свойства Transaction не равно null, создается исключение InvalidOperationException. Если значение свойства Transaction отлично от null и для транзакции уже произошла фиксация или откат, то свойство Transaction устанавливается в значение null.

Пример

В следующем примере создается команда SqlCeCommand, и свойству Connection присваивается объект SqlCeConnection.

Dim queryText As String = "SELECT * FROM Categories ORDER BY [Category ID]"
Dim cmd As New SqlCeCommand(queryText)

cmd.Connection = conn
cmd.CommandType = CommandType.Text

string queryText = "SELECT * FROM Categories ORDER BY [Category ID]";
SqlCeCommand cmd = new SqlCeCommand(queryText);

cmd.Connection = conn;
cmd.CommandType = CommandType.Text;

Многопоточное использование

Все общие статические члены (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

См. также

Справочник

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
SqlCeCommand.CommandText Property
SqlCeCommand.CommandTimeout Property
CommandType

Поделиться через