SqlCeCommand.CommandText Property

Статья
01/14/2011

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

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

Синтаксис

'Декларация
Public Overrides Property CommandText As String

public override string CommandText { get; set; }

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

public override function get CommandText () : String

public override function set CommandText (value : String)

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

Инструкция SQL для выполнения или имя открываемой базовой таблицы. Значение по умолчанию равно пустой строке.

Замечания

Если свойство CommandType имеет значение TableDirect, то значением свойства CommandText должно быть имя таблицы, к которой выполняется доступ. Доступ через TableDirect является самым быстрым способом получения данных из SQL Server Compact 3.5. Если имена таблиц содержат специальные символы, может потребоваться использование экранирующих символов. После вызова одного из методов выполнения производится возврат всех строк и столбцов указанной таблицы или таблиц.

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

Поставщик данных .NET Compact Framework для SQL Server Compact 3.5 поддерживает именованные параметры для передачи параметров в инструкцию SQL, вызываемую объектом SqlCeCommand, если свойство CommandType имеет значение Text. Например:

SELECT * FROM Customers WHERE CustomerID = @customerID

Поставщик данных для SQL Server Compact 3.5 не поддерживает пакетные запросы. Команды должны быть представлены в следующем формате. SELECT * FROM Customers, а не SELECT * FROM Customers; SELECT * FROM Orders. Возможно, перед выполнением кода, сформированного для System.Data.SqlClient, придется изменить запросы, приведя их в соответствие этому ограничению.

Задавайте имена столбцов для запросов INSERT, если используется репликация с поддержкой удаленного доступа к данным. Таблицы, отслеживаемые системой удаленного доступа к данным, содержат формируемые системой столбцы, и их наличие изменит число столбцов, ожидаемое в запросе. Если имена столбцов не заданы и количество столбцов в инструкции INSERT отличается от количества столбцов в таблице, инструкция INSERT завершится ошибкой.

Пример

В следующем примере создается команда SqlCeCommand, и производится присваивание значений CommandText и другим свойствам.

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both

SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

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

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

Share via