Свойство SqlCeCommand.CommandText
Возвращает или задает инструкцию SQL для выполнения в источнике данных.
Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)
Синтаксис
'Декларация
Public Overrides Property CommandText As String
Get
Set
'Применение
Dim instance As SqlCeCommand
Dim value As String
value = instance.CommandText
instance.CommandText = value
public override string CommandText { get; set; }
public:
virtual property String^ CommandText {
String^ get () override;
void set (String^ value) override;
}
abstract CommandText : string with get, set
override CommandText : string with get, set
override function get CommandText () : String
override function set CommandText (value : String)
Значение свойства
Тип: System.String
Инструкция SQL для выполнения или имя открываемой базовой таблицы. Значение по умолчанию равно пустой строке.
Реализует
Замечания
Если свойство CommandType имеет значение TableDirect, то значением свойства CommandText должно быть имя таблицы, к которой выполняется доступ. Доступ через TableDirect является самым быстрым способом получения данных из SQL Server Compact. Если имена таблиц содержат специальные символы, может потребоваться использование escape-символов. После вызова одного из методов выполнения производится возврат всех строк и столбцов указанной таблицы или таблиц.
Если текущее соединение выполняет операции Execute или Fetch, то установка свойств Connection, CommandType и CommandText невозможна.
Поставщик данных .NET Compact Framework для SQL Server Compact поддерживает именованные параметры для передачи параметров в инструкцию SQL, вызываемую объектом SqlCeCommand, если свойство CommandType имеет значение Text. Например:
SELECT * FROM Customers WHERE CustomerID = @customerID
Поставщик данных для SQL Server Compact не поддерживает пакетные запросы. Команды должны быть представлены в следующем формате: 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;