Partilhar via


ExecuteSQLTask Classe

Definição

Contém os membros usados para configurar e executar uma tarefa Executar SQL. A tarefa Executar SQL é usada para executar comandos SQL em uma exibição ou tabela de banco de dados relacional.

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
Herança
ExecuteSQLTask
Derivado
Atributos
Implementações

Comentários

Para obter mais informações sobre os recursos dessa tarefa, consulte Executar Tarefa SQL.

Construtores

ExecuteSQLTask()

Inicializa uma nova instância da classe ExecuteSQLTask.

Propriedades

BypassPrepare

Obtém ou define um Boolean que indica se a tarefa Executar SQL ignora a preparação da instrução ao enviar a instrução SQL para o RDBMS (sistema de gerenciamento de banco de dados relacional).

CodePage

Obtém ou define a página de código a ser usada durante a conversão dos valores de variável armazenados como caracteres amplos Unicode em caracteres multibyte. A conversão ocorre durante o armazenamento de valores nos bancos de dados ou durante a extração de valores dos bancos de dados.

Connection

Obtém ou define o nome do gerenciador de conexões que se conecta ao RDBMS em que a tarefa Executar SQL é executada.

ExecutionValue

Retorna o número de linhas afetadas por uma ou mais instruções SQL.

IsStoredProcedure

Obtém ou define um Boolean que indica se a instrução SQL especificada pela tarefa Executar SQL é um procedimento armazenado.

ParameterBindings

Retorna um objeto que implementa IDTSParameterBindings.

ResultSetBindings

Retorna um objeto que implementa IDTSParameterBindings.

ResultSetType

Obtém ou define um valor que indica o tipo de conjunto de resultados retornado pela instrução SQL executada pela tarefa Executar SQL.

SqlStatementSource

Obtém ou define o nome da fonte que contém a instrução SQL executada pela tarefa Executar SQL.

SqlStatementSourceType

Obtém ou define um valor que indica o tipo de fonte que contém a instrução SQL executada pela tarefa Executar SQL.

TargetServerVersion

Contém os membros usados para configurar e executar uma tarefa Executar SQL. A tarefa Executar SQL é usada para executar comandos SQL em uma exibição ou tabela de banco de dados relacional.

(Herdado de Task)
TimeOut

Obtém ou define um valor inteiro que indica o número máximo de segundos que a tarefa pode executar antes que o tempo limite seja excedido.

TypeConversionMode

Obtém ou define o modo de conversão usado pela tarefa Executar SQL.

Version

Membro preterido; consulte Comentários. *** Retorna a versão da tarefa. Esta propriedade é somente para leitura.

(Herdado de Task)

Métodos

CanUpdate(String)

Membro preterido; consulte Comentários. Um booliano que indica se o novo XML do pacote pode atualizar o XML do pacote antigo.

(Herdado de Task)
Equals(Object)

Determina se duas instâncias de objeto são iguais.

(Herdado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Executa a tarefa.

GetConnectionID(Connections, String)

Obtém uma cadeia de caracteres que contém a ID da conexão.

(Herdado de Task)
GetConnectionName(Connections, String)

Obtém uma cadeia de caracteres que contém o nome da conexão.

(Herdado de Task)
GetHashCode()

Retorna o código hash para a instância.

(Herdado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Inicializa as propriedades associadas à tarefa Executar SQL. Esse método é chamado pelo runtime e não é usado em código.

LoadFromXML(XmlElement, IDTSInfoEvents)

Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).

SaveToXML(XmlDocument, IDTSInfoEvents)

Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents).

Update(String)

Membro preterido; consulte Comentários. Esse método atualiza o XML do pacote antigo com o novo XML do pacote se CanUpdate(String) for definido como true.

(Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Verifica se a tarefa está configurada corretamente.

Aplica-se a