ForLoop Classe

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce un contenitore che definisce un flusso di lavoro iterativo in un pacchetto, utilizzando l'istruzione for iteration.

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

Ereditarietà: Object

DtsObject

Executable

DtsContainer

EventsProvider
ForLoop

Implementazioni: IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

Commenti

Durante l'esecuzione, il flusso di controllo nel ForLoop contenitore si ripete all'interno del flusso complessivo di controllo del pacchetto. In ogni iterazione del ciclo, il ForLoop contenitore valuta un'espressione e ripete il suo flusso di lavoro finché l'espressione non valuta fino a false. Per altre informazioni, vedere Contenitore Ciclo For.

Campi

Nome	Descrizione
m_executable	L'eseguibile. (Ereditato da Executable)

Proprietà

Nome	Descrizione
AssignExpression	Ottiene o imposta un'espressione per incrementare o decrementare il contatore di loop.
CreationName	Restituisce la stringa che viene usata per creare un'istanza dell'oggetto DtsContainer . Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
DebugMode	Ottiene o imposta un Booleano che indica se l'oggetto DtsContainer è in modalità debug e se deve attivare l'evento OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) durante l'esecuzione. (Ereditato da DtsContainer)
DelayValidation	Ottiene o imposta un Booleano che indica se la validazione del compito è ritardata fino al momento dell'esecuzione. Il valore predefinito è false. (Ereditato da DtsContainer)
Description	Ottiene o imposta la descrizione dell'oggetto DtsContainer . (Ereditato da DtsContainer)
Disable	Un Booleano che indica se l'oggetto DtsContainer è disabilitato. (Ereditato da DtsContainer)
DisableEventHandlers	Ottiene o imposta un Booleano che indica se i gestori di eventi sul task sono disabilitati. (Ereditato da EventsProvider)
EvalExpression	Ottiene o stabilisce l'espressione che viene valutata ad ogni passaggio del loop.
EventHandlers	Restituisce una collezione di oggetti gestori di eventi. Il campo è di sola lettura. (Ereditato da EventsProvider)
EventInfos	Restituisce una collezione di EventInfo oggetti. Il campo è di sola lettura. (Ereditato da EventsProvider)
Executables	Restituisce una raccolta di oggetti eseguibili che vengono elaborati durante l'iterazione ForLoop .
ExecutionDuration	Restituisce un valore che indica il tempo che il container ha impiegato in esecuzione, in millisecondi. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
ExecutionResult	Restituisce un valore che indica il successo o il fallimento dell'esecuzione dell'oggetto DtsContainer . (Ereditato da DtsContainer)
ExecutionStatus	Restituisce un valore che indica lo stato attuale dell'esecuzione dell'oggetto DtsContainer al momento della chiamata. (Ereditato da DtsContainer)
FailPackageOnFailure	Ottiene o imposta un Boolean che indica se il pacchetto fallisce quando un container figlio fallisce. Questa proprietà viene utilizzata sui contenitori, non sul pacchetto stesso. (Ereditato da DtsContainer)
FailParentOnFailure	Ottiene o imposta un `Boolean` che definisce se il contenitore genitore fallisce quando un container figlio fallisce. (Ereditato da DtsContainer)
ForcedExecutionValue	Se la ForceExecutionValue proprietà è impostata su True, ottiene o imposta un valore che specifica il valore di esecuzione opzionale restituito dal package. (Ereditato da DtsContainer)
ForceExecutionResult	Ottiene o imposta un DTSForcedExecResult valore di enumerazione che specifica il risultato di esecuzione forzata del contenitore. (Ereditato da DtsContainer)
ForceExecutionValue	Ottiene o imposta un Booleano che indica se il valore di esecuzione del contenitore deve essere forzato a contenere un valore particolare. (Ereditato da DtsContainer)
HasExpressions	Ottiene un valore che indica se l'oggetto ForLoop ha espressioni.
ID	Restituisce l'ID, che è una GUID, del DtsContainer. Il valore è di sola lettura. (Ereditato da DtsContainer)
InitExpression	Ottiene o imposta un'espressione di inizializzazione opzionale.
IsDefaultLocaleID	Un booleano che indica se il container utilizza la località predefinita. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
IsolationLevel	Ottiene o imposta il livello di isolamento della transazione nell'oggetto DtsContainer . (Ereditato da DtsContainer)
LocaleID	Ottiene o imposta un intero che indica il localID Microsoft Win32® da utilizzare quando l'oggetto DtsContainer viene eseguito. (Ereditato da DtsContainer)
LogEntryInfos	Restituisce un oggetto LogEntryInfos. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
LoggingMode	Ottiene o imposta un valore valido dall'enumerazione DTSLoggingMode che indica la modalità di logging del contenitore. (Ereditato da DtsContainer)
LoggingOptions	Restituisce un oggetto che contiene proprietà che indicano la risorsa di filtraggio e logging per i container. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
MaximumErrorCount	Ottiene o imposta un valore intero che indica il numero massimo di errori che possono verificarsi prima che l'oggetto DtsContainer smetta di eseguirsi. (Ereditato da DtsContainer)
Name	Ottiene o imposta il nome dell'oggetto DtsContainer. (Ereditato da DtsContainer)
Parent	Restituisce il contenitore principale. Il valore è di sola lettura. (Ereditato da DtsContainer)
PrecedenceConstraints	Restituisce una PrecedenceConstraints collezione. Il campo è di sola lettura.
Properties	Restituisce un insieme di proprietà per il ForLoop in una DtsProperties collezione.
Site	Ottiene o imposta il sito per il contenitore. (Ereditato da DtsContainer)
StartTime	Restituisce l'orario in cui il contenitore ha iniziato l'esecuzione. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
StopTime	Restituisce il momento in cui il contenitore ha terminato l'esecuzione. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
SuspendRequired	Ottiene o imposta un Booleano che indica se i compiti devono sospendere quando incontrano un punto di interruzione. Questo valore viene impostato dal motore di esecuzione per compiti e container quando si incontra un punto di interruzione. (Ereditato da DtsContainer)
TransactionOption	Ottiene o imposta un DTSTransactionOption valore di enumerazione che indica se il contenitore partecipa alle transazioni. (Ereditato da DtsContainer)
VariableDispenser	Restituisce un VariableDispenser oggetto in modo che le variabili associate al contenitore possano essere bloccate. (Ereditato da DtsContainer)
Variables	Restituisce una collezione che contiene le variabili associate a questo contenitore. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)

Metodi

Nome	Descrizione
AcceptBreakpointManager(BreakpointManager)	Questo metodo viene chiamato dal motore di esecuzione quando viene creato un compito o un contenitore, e lo passa a un BreakpointManager manager per permettere al task di creare, rimuovere e controllare lo stato dei punti di interruzione. Questo metodo è chiamato dal runtime e non viene utilizzato nel codice. (Ereditato da DtsContainer)
Dispose()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite. (Ereditato da DtsContainer)
Equals(Object)	Determina se due istanze dell'oggetto sono uguali. (Ereditato da DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Esegue l'applicazione, il contenitore o il pacchetto come parte di un flusso di lavoro del pacchetto. (Ereditato da DtsContainer)
GetExecutionPath()	Ottiene il percorso di esecuzione per l'oggetto ForLoop .
GetExpression(String)	Restituisce una stringa che contiene l'espressione per la proprietà specificata. Nullo significa che nessuna espressione viene assegnata.
GetHashCode()	Restituisce il codice hash per questa istanza. (Ereditato da DtsObject)
GetPackagePath()	Restituisce una stringa che contiene il percorso relativo alla posizione del pacchetto.
LoadFromXML(XmlNode, IDTSEvents)	Questo metodo non è richiamabile dal codice applicativo. Per caricare un pacco salvato come .xml, usa il LoadPackage(String, IDTSEvents) metodo. (Ereditato da DtsContainer)
ResumeExecution()	Riprende l'esecuzione del compito dopo la pausa. Il compito o il contenitore viene ripreso dal motore di runtime. (Ereditato da DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Questo metodo non è richiamabile dal codice applicativo. Per salvare un pacchetto come .xml, usa il SaveToXml(String, Package, IDTSEvents) metodo. (Ereditato da DtsContainer)
SetExpression(String, String)	Assegna l'espressione specificata alla proprietà. Specificare null per rimuovere un'espressione esistente dalla proprietà.
SetWrappedExecutable(IDTSExecutable100)	Restituisce l'oggetto eseguibile avvolto. (Ereditato da EventsProvider)
SuspendExecution()	Chiamato quando l'eseguibile deve essere sospeso. Questo metodo è chiamato dal motore di runtime. (Ereditato da DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Permette al contenitore di determinare se contiene impostazioni non valide che impediranno l'esecuzione con successo. (Ereditato da DtsContainer)

Eventi

Nome	Descrizione
Disposed	Aggiunge un gestore eventi per restare in ascolto dell'evento Disposed nel componente. (Ereditato da DtsContainer)

Si applica a