SqlCeCommand Class

Статья
01/14/2011

Представляет инструкцию SQL, предназначенную для выполнения в источнике данных.

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

Синтаксис

'Декларация
Public NotInheritable Class SqlCeCommand
    Inherits DbCommand
    Implements ICloneable

public sealed class SqlCeCommand : DbCommand, ICloneable

public ref class SqlCeCommand sealed : public DbCommand, ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

Замечания

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

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

Метод	Описание
ExecuteReader	Выполняет команды, которые возвращают строки.
ExecuteNonQuery	Выполняет INSERT, DELETE и UPDATE и другие инструкции SQL.
ExecuteScalar	Производит выборку из базы данных единичного значения (например полученного в результате статистической обработки).
ExecuteResultSet	Выполняет команды и возвращает результирующий набор.

Поставщик данных для SQL Server Compact 3.5 не поддерживает пакетные запросы. Команды должны быть представлены в следующем формате.

Select * from Customers , но не Select * from Customers; Select * from Orders;

Возможно, перед выполнением кода, сформированного для System.Data.SqlClient, придется изменить запросы, приведя их в соответствие этому ограничению.

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

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

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

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

Пример

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

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    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

См. также

Справочник

SqlCeCommand Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeConnection

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