ForLoop 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 para iteração.

public ref class ForLoop 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 ForLoop : 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 ForLoop = class
    inherit EventsProvider
    interface IDTSSequence
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

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

Herança: Object

DtsObject

Executable

DtsContainer

EventsProvider
ForLoop

Implementações: IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

Comentários

Em tempo de execução, o fluxo de controle no ForLoop contêiner é repetido dentro do fluxo de controle geral do pacote. Em cada iteração do loop, o ForLoop contêiner avalia uma expressão e repete seu fluxo de trabalho até que a expressão seja avaliada falsecomo . Para obter mais informações, consulte Contêiner Loop For.

Campos

m_executable

O executável.

(Herdado de Executable)

Propriedades

AssignExpression	Obtém ou define uma expressão para incrementar ou decrementar o contador cíclico.
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)
EvalExpression	Obtém ou define a expressão que é avaliada a cada passagem do loop.
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 executáveis que são processados durante a iteração ForLoop.
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 estiver definida como True, obtém ou define 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 Boolean que indica se o valor de execução do contêiner deve ser forçado a conter um valor específico. (Herdado de DtsContainer)
HasExpressions	Obtém um valor que indica se o objeto ForLoop tem expressões.
ID	Retorna a ID que é um GUID do DtsContainer. O valor é somente leitura. (Herdado de DtsContainer)
InitExpression	Obtém ou define uma expressão de inicialização opcional.
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. Este campo é somente leitura.
Properties	Retorna um conjunto de propriedades para o ForLoop em uma coleção DtsProperties.
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 Boolean 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)
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 ForLoop.
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

Partilhar via