ForEachLoop Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece um contêiner que define um fluxo de trabalho iterativo em um pacote usando a instrução de iteração foreach.

public ref class ForEachLoop sealed : Microsoft::SqlServer::Dts::Runtime::EventsProvider, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx, Microsoft::SqlServer::Dts::Runtime::IDTSSequence

public sealed class ForEachLoop : Microsoft.SqlServer.Dts.Runtime.EventsProvider, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx, Microsoft.SqlServer.Dts.Runtime.IDTSSequence

type ForEachLoop = class
    inherit EventsProvider
    interface IDTSSequence
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

Public NotInheritable Class ForEachLoop
Inherits EventsProvider
Implements IDTSExecutionPath, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx, IDTSSequence

Herança: Object

DtsObject

Executable

DtsContainer

EventsProvider
ForEachLoop

Implementações: IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

Comentários

Em tempo de execução, o fluxo de controle no ForEachLoop contêiner é repetido dentro do fluxo de controle geral do pacote.

Campos

m_executable

O executável.

(Herdado de Executable)

Propriedades

CreationName	Retorna a cadeia de caracteres usada para criar uma instância do objeto DtsContainer. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
DebugMode	Obtém ou define um Boolean que indica se o DtsContainer objeto está no modo de depuração e se ele deve disparar o evento durante a OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) execução. (Herdado de DtsContainer)
DelayValidation	Obtém ou define um Boolean que indica se a validação da tarefa está atrasada até o tempo de execução. O valor padrão é false. (Herdado de DtsContainer)
Description	Obtém ou define a descrição do objeto DtsContainer. (Herdado de DtsContainer)
Disable	Um booliano que indica se o DtsContainer objeto está desabilitado. (Herdado de DtsContainer)
DisableEventHandlers	Obtém ou define um Boolean que indica se os manipuladores de eventos na tarefa estão desabilitados. (Herdado de EventsProvider)
EventHandlers	Retorna uma coleção de objetos de manipulador de eventos. Este campo é somente leitura. (Herdado de EventsProvider)
EventInfos	Retorna uma coleção de objetos EventInfo. Este campo é somente leitura. (Herdado de EventsProvider)
Executables	Retorna uma coleção de objetos Executable processados pelo mecanismo de Tempo de Execução de Transformação de Dados durante a execução do ForEachLoop. Este campo é somente leitura.
ExecutionDuration	Retorna um valor que indica a quantidade de tempo gasta pelo contêiner na execução, em milissegundos. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
ExecutionResult	Retorna um valor que indica o êxito ou a falha da execução do objeto DtsContainer. (Herdado de DtsContainer)
ExecutionStatus	Retorna um valor que indica o status atual da execução do objeto DtsContainer na hora da chamada. (Herdado de DtsContainer)
FailPackageOnFailure	Obtém ou define um Boolean que indica se o pacote falha quando um contêiner filho falha. Essa propriedade é usada em contêineres, não no próprio pacote. (Herdado de DtsContainer)
FailParentOnFailure	Obtém ou define um `Boolean` que define se há falha no contêiner pai quando há falha em um contêiner filho. (Herdado de DtsContainer)
ForcedExecutionValue	Se a ForceExecutionValue propriedade for definida como True, obterá ou definirá um valor que especifica o valor de execução opcional que o pacote retorna. (Herdado de DtsContainer)
ForceExecutionResult	Obtém ou define um valor de enumeração DTSForcedExecResult que especifica o resultado da execução forçada do contêiner. (Herdado de DtsContainer)
ForceExecutionValue	Obtém ou define um booliano que indica se o valor de execução do contêiner deve ser forçado a conter um valor específico. (Herdado de DtsContainer)
ForEachEnumerator	Obtém ou define um host para o ForEachEnumerator.
HasExpressions	Obtém um valor que indica se o objeto ForEachLoop tem expressões.
ID	Retorna a ID que é um GUID do DtsContainer. O valor é somente leitura. (Herdado de DtsContainer)
IsDefaultLocaleID	Um booliano que indica se o contêiner usa a localidade padrão. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
IsolationLevel	Obtém ou define o nível de isolamento da transação no objeto DtsContainer. (Herdado de DtsContainer)
LocaleID	Obtém ou define um Inteiro que indica a localidade do Microsoft Win32® a ser usada quando o DtsContainer objeto é executado. (Herdado de DtsContainer)
LogEntryInfos	Retorna um objeto LogEntryInfos. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
LoggingMode	Obtém ou define um valor válido da enumeração DTSLoggingMode que indica o modo de log do contêiner. (Herdado de DtsContainer)
LoggingOptions	Retorna um objeto que contém propriedades que indicam a filtragem e o recurso de log para contêineres. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
MaximumErrorCount	Obtém ou define um valor inteiro que indica o número máximo de erros que podem ocorrer antes que o DtsContainer objeto pare de ser executado. (Herdado de DtsContainer)
Name	Obtém ou define o nome de DtsContainer. (Herdado de DtsContainer)
Parent	Retorna o contêiner pai. O valor é somente leitura. (Herdado de DtsContainer)
PrecedenceConstraints	Retorna uma coleção PrecedenceConstraints que contém todas as restrições de precedência associadas ao ForEachLoop.
Properties	Retorna uma coleção de objetos DtsProperty associados ao ForEachLoop.
Site	Obtém ou define o local do contêiner. (Herdado de DtsContainer)
StartTime	Retorna a hora em que o contêiner começou execução. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
StopTime	Retorna a hora em que o contêiner encerrou a execução. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
SuspendRequired	Obtém ou define um booliano que indica se as tarefas devem ser suspensas quando encontram um ponto de interrupção. Esse valor é definido pelo mecanismo de runtime para tarefas e contêineres quando um ponto de interrupção é encontrado. (Herdado de DtsContainer)
TransactionOption	Obtém ou define um valor de enumeração DTSTransactionOption que indica se o contêiner participa de transações. (Herdado de DtsContainer)
VariableDispenser	Retorna um objeto VariableDispenser de forma que as variáveis associadas ao contêiner possam ser bloqueadas. (Herdado de DtsContainer)
VariableMappings	Retorna uma coleção ForEachVariableMappings que contém os mapeamentos de variáveis para o ForEachLoop.
Variables	Retorna uma coleção que contém as variáveis associadas a este contêiner. Esta propriedade é somente para leitura. (Herdado de DtsContainer)

Métodos

AcceptBreakpointManager(BreakpointManager)	Este método é chamado pelo mecanismo de tempo de execução quando uma tarefa ou um contêiner é criado e o transmite para um gerenciador de BreakpointManager para permitir que a tarefa crie, remova e verifique o status dos pontos de interrupção. Esse método é chamado pelo runtime e não é usado em código. (Herdado de DtsContainer)
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DtsContainer)
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Executa o aplicativo, o contêiner ou o pacote como parte de um fluxo de trabalho de pacote. (Herdado de DtsContainer)
GetExecutionPath()	Obtém o caminho de execução do objeto ForEachLoop.
GetExpression(String)	Retorna uma cadeia de caracteres que contém a expressão da propriedade especificada. Nulo significa que nenhuma expressão é atribuída.
GetHashCode()	Retorna o código hash para a instância. (Herdado de DtsObject)
GetPackagePath()	Retorna uma cadeia de caracteres que contém o caminho relativo para o local do pacote.
LoadFromXML(XmlNode, IDTSEvents)	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). (Herdado de DtsContainer)
ResumeExecution()	Retoma a execução da tarefa depois de pausar. A tarefa ou o contêiner é retomado pelo mecanismo de runtime. (Herdado de DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	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). (Herdado de DtsContainer)
SetExpression(String, String)	Atribui a expressão especificada à propriedade. Especifique nulo para remover uma expressão existente da propriedade.
SetWrappedExecutable(IDTSExecutable100)	Retorna o objeto executável encapsulado. (Herdado de EventsProvider)
SuspendExecution()	Chamado quando o executável precisa ser suspenso. Esse método é chamado pelo mecanismo de runtime. (Herdado de DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Permite que o contêiner determine se ele contém configurações inválidas que o impedirão de ser executado com êxito. (Herdado de DtsContainer)

Eventos

Disposed

Adiciona um manipulador de eventos para escutar o evento Disposed no componente.

(Herdado de DtsContainer)

Aplica-se a