Package 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.

Rappresenta il contenitore del pacchetto. La classe non può essere ereditata.

public ref class Package sealed : Microsoft::SqlServer::Dts::Runtime::EventsProvider, Microsoft::SqlServer::Dts::Runtime::IDTSConfigurationControl, 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 Package : Microsoft.SqlServer.Dts.Runtime.EventsProvider, Microsoft.SqlServer.Dts.Runtime.IDTSConfigurationControl, 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 Package = class
    inherit EventsProvider
    interface IDTSSequence
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath
    interface IDTSConfigurationControl

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

Ereditarietà: Object

DtsObject

Executable

DtsContainer

EventsProvider
Package

Implementazioni: IDTSConfigurationControl IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

Commenti

Il pacchetto è una raccolta di altri container, connessioni, compiti, trasformazioni, variabili, configurazioni e vincoli di precedenza. I pacchetti possono essere creati in modo programmativo o utilizzando lo strumento grafico SSIS Designer. I pacchetti possono essere salvati in varie località, inclusi Microsoft SQL Server o un file XML.

Per ulteriori informazioni sui pacchetti, vedi Integration Services (SSIS) Packages.

Costruttori

Nome	Descrizione
Package()	Inizializza una nuova istanza della classe Package.

Campi

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

Proprietà

Nome	Descrizione
CertificateContext	Ottiene o imposta l'oggetto certificato X.509 per il pacchetto.
CertificateObject	Ottiene o imposta l'oggetto certificato X.509 per il pacchetto.
CheckpointFileName	Ottiene o imposta il nome del file che cattura le informazioni del checkpoint, permettendo così a un pacchetto di riavviarsi.
CheckpointUsage	Ottiene o imposta un valore che specifica se o quando un pacchetto viene riavviato.
CheckSignatureOnLoad	Riceve o imposta un valore che indica se la firma digitale viene controllata quando un pacco viene caricato.
Configurations	Ottiene la collezione di configurazioni per il pacchetto. Un pacchetto può avere più di una configurazione associata. Questa proprietà è di sola lettura.
Connections	Ottiene la collezione di gestori di connessione per il pacchetto.
CreationDate	Ottiene o imposta la data e l'ora in cui il pacchetto è stato creato.
CreationName	Restituisce la stringa che viene usata per creare un'istanza dell'oggetto DtsContainer . Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
CreatorComputerName	Ottiene o imposta il nome del computer su cui è stato creato il pacchetto.
CreatorName	Ottiene o imposta il nome della persona che ha creato il pacchetto.
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)
DesignEvents	Riceve o imposta un IDTSEvents evento che indica se il designer o un altro client di terze parti deve ricevere eventi durante il tempo di progettazione.
DesignTimeProperties	Ottiene o imposta le proprietà del tempo di progettazione di un pacchetto, come le informazioni di layout.
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)
DumpDescriptor	Specifica quando deve essere generato un file dump.
DumpOnAnyError	Specificare se un file dump debba essere generato quando si verifica un errore durante l'esecuzione del pacchetto.
EnableConfigurations	Ottiene o imposta un valore che indica se il pacchetto carica configurazioni.
EnableDump	Specifica se la generazione del file di dump è abilitata.
EncryptCheckpoints	Ottiene o imposta un valore che indica se i file dei checkpoint sono criptati.
Errors	Riceve la raccolta di errori associati al pacchetto. Il campo è di sola lettura.
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	Ottiene la collezione di oggetti eseguibili contenuti nel pacchetto che fanno parte del flusso di lavoro del pacchetto.
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)
ExtendedProperties	Riceve la ExtendedProperties collezione del pacco.
FailPackageOnFailure	Ottiene o imposta un valore che indica se il pacchetto fallisce quando un compito o un componente del pacchetto fallisce.
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	Riceve un valore che indica se il pacchetto ha espressioni.
ID	Restituisce l'ID, che è una GUID, del DtsContainer. Il valore è di sola lettura. (Ereditato da DtsContainer)
IgnoreConfigurationsOnLoad	Ottiene o imposta un valore che indica se il pacchetto ignora le configurazioni quando il pacchetto viene caricato.
InteractiveMode	Ottiene o imposta un valore che indica se i compiti devono mostrare oggetti dell'interfaccia utente durante l'esecuzione.
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)
LogProviders	Ottiene la collezione di fornitori di log associati al pacchetto.
MaxConcurrentExecutables	Ottiene o imposta il numero di thread che un pacchetto può creare.
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)
OfflineMode	Riceve o imposta un valore che indica se il pacchetto funziona in modalità offline.
PackagePassword	Imposta il valore della password per il pacco. Questa proprietà è solo scrittura.
PackagePriorityClass	Specifica la classe di priorità del thread Win32 del thread del package.
PackageType	Specifica un valore che identifica lo strumento che ha creato il pacchetto.
PackageUpgradeOptions	Ottiene o imposta le opzioni di upgrade per il pacchetto.
Parameters	Ottiene la raccolta dei parametri per il pacchetto.
Parent	Restituisce il contenitore principale. Il valore è di sola lettura. (Ereditato da DtsContainer)
PrecedenceConstraints	Ottiene l'insieme degli PrecedenceConstraint oggetti . Il campo è di sola lettura.
Project	Ottiene o imposta il progetto specificato associato al pacchetto.
Properties	Ottiene la raccolta dell'oggetto DtsProperties per il pacchetto.
ProtectionLevel	Ha il livello di protezione della confezione.
SafeRecursiveProjectPackageExecution	Ottiene o imposta un valore che indica se l'esecuzione ricorsiva del pacchetto è sicura.
SaveCheckpoints	Riceve o imposta un valore che indica se il pacchetto utilizzerà i checkpoint durante l'esecuzione del pacchetto.
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)
SuppressConfigurationWarnings	Ottiene o imposta un valore che indica se gli avvisi generati dalle configurazioni sono soppressi.
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)
UpdateObjects	Membro deprecato; vedi Osservazioni. Ottiene o imposta un valore che indica se gli oggetti estensibili possono essere aggiornati al momento del caricamento del pacchetto se viene trovata una versione aggiornata.
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)
VersionBuild	Riceve la versione build del pacchetto.
VersionComments	Riceve i commenti della versione associati al pacchetto.
VersionGUID	Riceve la versione GUID generata quando il pacchetto viene creato per la prima volta. Il campo è di sola lettura.
VersionMajor	Ottiene la versione principale del pacchetto.
VersionMinor	Riceve la versione minore del pacchetto.
Warnings	Imposta la raccolta di avvisi sul pacchetto. Il campo è di sola lettura.

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)
AddDataTapPoint(String, String, Int32, String)	Aggiungi un punto di tap dati su un dato flusso dati e su un percorso di flusso dati dato.
CheckSignature()	Controlla lo stato della firma digitale del pacco.
ComputeExpressions(Boolean)	Calcolare le espressioni dell'oggetto package.
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()	Restituisce un'enumerazione DTSExecResult che contiene informazioni sul successo o fallimento dell'esecuzione del pacchetto.
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)
ExportConfigurationFile(String)	Crea un file XML che contiene tutte le variabili deployabili nel pacchetto.
FindReferencedObjects(Object)	Restituisce un'enumerazione di oggetti di riferimento.
GetBreakpointTargets(IDTSBreakpointSite, Boolean)	Restituisce una BreakpointTargets collezione. A seconda dell'impostazione del `onlyEnabled` parametro, la collezione contiene tutti i target di breakpoint nel package, o solo i target di breakpoint abilitati.
GetExecutionPath()	Restituisce il percorso di esecuzione del pacchetto corrente.
GetExpression(String)	Restituisce un valore 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)
GetObjectFromPackagePath(String, DtsProperty)	Restituisce una proprietà del pacchetto e l'oggetto dal percorso specificato del package.
GetPackagePath()	Restituisce un valore che contiene il percorso relativo alla posizione del pacchetto.
ImportConfigurationFile(String)	Carica un file di configurazione associato al pacchetto.
LoadFromXML(String, IDTSEvents)	Carica un pacchetto e tutti i suoi oggetti salvati in memoria in formato XML. Per caricare un pacchetto che viene salvato sull'hard disk, usa il LoadPackage(String, IDTSEvents) metodo.
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)
LoadUserCertificateByHash(Byte[])	Carica il certificato del pacchetto secondo l'hash del certificato.
LoadUserCertificateByName(String)	Carica il certificato del pacco secondo il nome del certificato.
ProcessConfiguration(String, Object)	Specifica le informazioni di configurazione per un pacchetto e i suoi oggetti.
RegenerateID()	Crea un nuovo GUID per il pacchetto e aggiorna la proprietà ID del pacchetto.
ResumeExecution()	Riprende l'esecuzione del compito dopo la pausa. Il compito o il contenitore viene ripreso dal motore di runtime. (Ereditato da DtsContainer)
SaveToXML(String, IDTSEvents)	Salva il pacchetto in memoria in formato XML. Per salvare un pacchetto come .xml sull'hard disk, usa il SaveToXml(String, Package, IDTSEvents) metodo.
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