ExecuteSQLTask Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит элементы, используемые для настройки и выполнения задачи Execute SQL. Задача Execute SQL используется для выполнения SQL-команд против реляционной таблицы или представления базы данных.
public ref class ExecuteSQLTask : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::ExecuteSQLTask::IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("EBC1FA93-45A9-444F-BBDC-B4F5265863C3")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("855117DC-EA42-4532-8D53-8E4FC09662CE")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("736DDEB9-5DA1-4841-B5A7-F08CC574307F")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("EBC1FA93-45A9-444F-BBDC-B4F5265863C3")>]
type ExecuteSQLTask = class
inherit Task
interface IDTSExecuteSQL
interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("855117DC-EA42-4532-8D53-8E4FC09662CE")>]
type ExecuteSQLTask = class
inherit Task
interface IDTSExecuteSQL
interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("736DDEB9-5DA1-4841-B5A7-F08CC574307F")>]
type ExecuteSQLTask = class
inherit Task
interface IDTSExecuteSQL
interface IDTSComponentPersist
Public Class ExecuteSQLTask
Inherits Task
Implements IDTSComponentPersist, IDTSExecuteSQL
- Наследование
- Производный
- Атрибуты
- Реализации
Комментарии
Для получения дополнительной информации о функциях этой задачи см. раздел «Выполнить задачу SQL».
Конструкторы
| Имя | Описание |
|---|---|
| ExecuteSQLTask() |
Инициализирует новый экземпляр класса ExecuteSQLTask. |
Свойства
| Имя | Описание |
|---|---|
| BypassPrepare |
Получает или устанавливает булевый элемент, который показывает, пропускает ли задача Execute SQL подготовку оператора при отправке SQL-оператора в реляционную систему управления базами данных (RDBMS). |
| CodePage |
Получает или устанавливает кодовую страницу для использования при переводе значений переменных, хранящихся как символы широкого Unicode, в многобайты. Трансляция происходит либо при хранении значений в базе данных, либо при извлечении из них значений. |
| Connection |
Получает или устанавливает имя менеджера соединений, который подключается к реляционной системе управления базами данных (RDBMS), где выполняется задача Execute SQL. |
| ExecutionValue |
Возвращает количество строк, на которые влияет SQL-оператор или операторы. |
| IsStoredProcedure |
Получает или устанавливает булевое значение, которое указывает, является ли SQL-оператор, указанный задачей Execute SQL, сохранённой процедурой. |
| ParameterBindings |
Возвращает объект, реализующий IDTSParameterBindings. |
| ResultSetBindings |
Возвращает объект, реализующий IDTSParameterBindings. |
| ResultSetType |
Получает или устанавливает значение, указывающее тип результатов, возвращаемого SQL-оператором, выполняемым задачами Execute SQL. |
| SqlStatementSource |
Получает или устанавливает имя исходного кода, содержащего SQL-оператор, выполняемый задачей Execute SQL. |
| SqlStatementSourceType |
Получает или устанавливает значение, указывающее тип исходного кода, содержащего SQL-оператор, выполняемый задачей Execute SQL. |
| TargetServerVersion |
Содержит элементы, используемые для настройки и выполнения задачи Execute SQL. Задача Execute SQL используется для выполнения SQL-команд против реляционной таблицы или представления базы данных. (Унаследовано от Task) |
| TimeOut |
Получает или устанавливает целое число, указывающее максимальное количество секунд, за которое задача может выполняться до тайм-аута. |
| TypeConversionMode |
Получает или устанавливает режим преобразования, используемый задачей Execute SQL. |
| Version |
Член уходил из употребления; см. Примечания. Возвращает версию задачи. Это свойство доступно только для чтения. (Унаследовано от Task) |
Методы
| Имя | Описание |
|---|---|
| CanUpdate(String) |
Член уходил из употребления; см. Примечания. Булевое значение, указывающее, может ли новый XML пакета обновлять старый XML пакета. (Унаследовано от Task) |
| Equals(Object) |
Определяет, равны ли два экземпляра объекта. (Унаследовано от DtsObject) |
| Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object) |
Выполняет задачу. |
| GetConnectionID(Connections, String) |
Получает строку с идентификатором соединения. (Унаследовано от Task) |
| GetConnectionName(Connections, String) |
Получает строку с названием соединения. (Унаследовано от Task) |
| GetHashCode() |
Возвращает хэш-код для этого экземпляра. (Унаследовано от DtsObject) |
| InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker) |
Инициализирует свойства, связанные с задачей Execute SQL. Этот метод вызывается в среде выполнения и не используется в коде. |
| LoadFromXML(XmlElement, IDTSInfoEvents) |
Этот метод не может быть вызван вашим кодом приложения. Чтобы загрузить пакет, сохранённый как .xml, используйте метод.LoadPackage(String, IDTSEvents) |
| SaveToXML(XmlDocument, IDTSInfoEvents) |
Этот метод не может быть вызван вашим кодом приложения. Чтобы сохранить посылку как .xml, используйте метод.SaveToXml(String, Package, IDTSEvents) |
| Update(String) |
Член уходил из употребления; см. Примечания. Этот метод обновляет XML старого пакета с новым XML пакета, если CanUpdate(String) установлен true. (Унаследовано от Task) |
| Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging) |
Проверяет, правильно ли настроена задача. |