Compartilhar via


ForEachLoop Classe

Definição

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
Implementações

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