Package Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt den Paketcontainer dar. Diese Klasse kann nicht vererbt werden.
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
- Vererbung
- Implementiert
Hinweise
Das Paket ist eine Sammlung anderer Container, Verbindungen, Vorgänge, Transformationen, Variablen, Konfigurationen und Vorrangeinschränkungen. Pakete können programmgesteuert oder mithilfe des grafischen Tools des SSIS Designer erstellt werden. Pakete können an verschiedenen Speicherorten gespeichert werden, einschließlich Microsoft SQL Server oder einer XML-Datei.
Weitere Informationen zu Paketen finden Sie unter Integration Services (SSIS)-Pakete.
Konstruktoren
Package() |
Initialisiert eine neue Instanz der Package-Klasse. |
Felder
m_executable |
Die ausführbare Datei. (Geerbt von Executable) |
Eigenschaften
CertificateContext |
Ruft das X.509-Zertifikatobjekt für das Paket ab oder legt es fest. |
CertificateObject |
Ruft das X.509-Zertifikatobjekt für das Paket ab oder legt es fest. |
CheckpointFileName |
Ruft den Namen der Datei ab, die die Prüfpunktinformationen aufzeichnet, mit denen ein Paket neu gestartet werden kann, oder legt ihn fest. |
CheckpointUsage |
Ruft einen Wert ab, der angibt, ob oder wann ein Paket neu gestartet wird, oder legt ihn fest. |
CheckSignatureOnLoad |
Ruft einen Wert ab, der angibt, ob die digitale Signatur beim Laden eines Pakets überprüft wird, oder legt ihn fest. |
Configurations |
Ruft die Auflistung der Konfigurationen für das Paket ab. Einem Paket kann mehr als eine Konfiguration zugeordnet werden. Diese Eigenschaft ist schreibgeschützt. |
Connections |
Ruft die Auflistung von Verbindungs-Managern für das Paket ab. |
CreationDate |
Ruft das Datum und die Uhrzeit der Paketerstellung ab oder legt sie fest. |
CreationName |
Gibt die Zeichenfolge zurück, die zum Erstellen einer Instanz des DtsContainer-Objekts verwendet wird. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
CreatorComputerName |
Ruft den Namen des Computers ab, auf dem das Paket erstellt wurde, oder legt ihn fest. |
CreatorName |
Ruft den Namen des Benutzers ab, der das Paket erstellt hat, oder legt ihn fest. |
DebugMode |
Ruft einen Boolean ab, der angibt, ob sich das DtsContainer Objekt im Debugmodus befindet und ob das Ereignis während der OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) Ausführung ausgelöst werden soll, oder legt ihn fest. (Geerbt von DtsContainer) |
DelayValidation |
Ruft einen Boolean ab oder legt diesen fest, der angibt, ob die Überprüfung des Vorgangs bis zur Laufzeit verzögert wird. Der Standardwert ist „FALSE“. (Geerbt von DtsContainer) |
Description |
Ruft die Beschreibung des DtsContainer-Objekts ab oder legt sie fest. (Geerbt von DtsContainer) |
DesignEvents |
Ruft IDTSEvents ab, die angeben, ob der Designer oder andere Drittanbieterclients während der Entwurfszeit Ereignisse empfangen sollen, oder legt sie fest. |
DesignTimeProperties |
Ruft die Entwurfszeiteigenschaften eines Pakets ab, z. B. Layoutinformationen, oder legt die Eigenschaften fest. |
Disable |
Ein Boolescher Wert, der angibt, ob das DtsContainer Objekt deaktiviert ist. (Geerbt von DtsContainer) |
DisableEventHandlers |
Ruft einen Booleschen Wert ab oder legt diesen fest, der angibt, ob die Ereignishandler für die Aufgabe deaktiviert sind. (Geerbt von EventsProvider) |
DumpDescriptor |
Gibt an, wann eine Dumpdatei generiert werden soll. |
DumpOnAnyError |
Gibt an, ob eine Dumpdatei generiert werden soll, wenn während der Paketausführung Fehler auftreten. |
EnableConfigurations |
Ruft einen Wert ab, der angibt, ob das Paket Konfigurationen lädt, oder legt ihn fest. |
EnableDump |
Gibt an, ob das Generieren der Dumpdatei aktiviert ist. |
EncryptCheckpoints |
Ruft einen Wert ab, der angibt, ob die Prüfpunktdateien verschlüsselt werden, oder legt ihn fest. |
Errors |
Ruft die Auflistung von Fehlern ab, die dem Paket zugeordnet sind. Dieses Feld ist schreibgeschützt. |
EventHandlers |
Gibt eine Auflistung von Ereignishandlerobjekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider) |
EventInfos |
Gibt eine Auflistung von EventInfo-Objekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider) |
Executables |
Ruft die Auflistung ausführbarer Objekte im Paket ab, die Bestandteil des Paketworkflows sind. |
ExecutionDuration |
Gibt einen Wert zurück, der die Zeitdauer für die Ausführung des Containers in Millisekunden angibt. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
ExecutionResult |
Gibt einen Wert zurück, der angibt, ob die Ausführung des DtsContainer-Objekts erfolgreich oder fehlerhaft war. (Geerbt von DtsContainer) |
ExecutionStatus |
Gibt einen Wert zurück, der den aktuellen Ausführungsstatus des DtsContainer-Objekts zur Zeit des Aufrufs angibt. (Geerbt von DtsContainer) |
ExtendedProperties |
Ruft die ExtendedProperties-Auflistung für das Paket ab. |
FailPackageOnFailure |
Ruft einen Wert ab, der angibt, ob das Paket scheitert, wenn ein Task oder eine Komponente im Paket scheitert, oder legt ihn fest. |
FailParentOnFailure |
Ruft einen |
ForcedExecutionValue |
Wenn die ForceExecutionValue Eigenschaft auf True festgelegt ist, ruft einen Wert ab oder legt einen Wert fest, der den optionalen Ausführungswert angibt, den das Paket zurückgibt. (Geerbt von DtsContainer) |
ForceExecutionResult |
Ruft einen DTSForcedExecResult-Enumerationswert ab, der das erzwungene Ausführungsergebnis des Containers angibt, oder legt ihn fest. (Geerbt von DtsContainer) |
ForceExecutionValue |
Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob der Ausführungswert des Containers gezwungen werden soll, einen bestimmten Wert zu enthalten. (Geerbt von DtsContainer) |
HasExpressions |
Ruft einen Wert ab, der angibt, ob das Paket Ausdrücke enthält. |
ID |
Gibt die ID von DtsContainer zurück. Die ID ist eine GUID. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer) |
IgnoreConfigurationsOnLoad |
Ruft einen Wert ab, der angibt, ob Konfigurationen beim Laden des Pakets ignoriert werden, oder legt ihn fest. |
InteractiveMode |
Ruft einen Wert ab, der angibt, ob beim Ausführen von Tasks Benutzeroberflächenobjekte angezeigt werden sollen, oder legt ihn fest. |
IsDefaultLocaleID |
Ein Boolescher Wert, der angibt, ob der Container das Standardschema verwendet. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
IsolationLevel |
Ruft die Isolationsstufe der Transaktion im DtsContainer-Objekt ab oder legt sie fest. (Geerbt von DtsContainer) |
LocaleID |
Ruft eine Integer ab, die die Microsoft Win32® LocaleID angibt, die verwendet werden soll, wenn das DtsContainer Objekt ausgeführt wird. (Geerbt von DtsContainer) |
LogEntryInfos |
Gibt ein LogEntryInfos-Objekt zurück. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
LoggingMode |
Ruft einen gültigen Wert aus der DTSLoggingMode-Enumeration ab, der den Protokollierungsmodus des Containers angibt, oder legt ihn fest. (Geerbt von DtsContainer) |
LoggingOptions |
Gibt ein Objekt mit Eigenschaften zurück, die die Filterung und Protokollierung von Ressourcen für Container angeben. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
LogProviders |
Ruft die Auflistung von Protokollanbietern ab, die dem Paket zugeordnet sind. |
MaxConcurrentExecutables |
Ruft die Anzahl von Threads ab, die ein Paket erstellen kann, oder legt sie fest. |
MaximumErrorCount |
Ruft einen Integer-Wert ab, der die maximale Anzahl von Fehlern angibt, die auftreten können, bevor das DtsContainer Objekt beendet wird. (Geerbt von DtsContainer) |
Name |
Ruft den Namen der DtsContainer ab oder legt diesen fest. (Geerbt von DtsContainer) |
OfflineMode |
Ruft einen Wert ab, der angibt, ob das Paket im Offlinemodus verwendet werden kann, oder legt ihn fest. |
PackagePassword |
Legt den Wert des Kennworts für das Paket fest. Diese Eigenschaft ist lesegeschützt. |
PackagePriorityClass |
Gibt die Win32-Threadprioritätsklasse des Paketthreads an. |
PackageType |
Gibt einen Wert an, durch den das Tool zur Paketerstellung identifiziert wird. |
PackageUpgradeOptions |
Ruft die Upgradeoptionen für das Paket ab oder legt sie fest. |
Parameters |
Ruft die Parameterauflistung für das Paket ab. |
Parent |
Gibt den übergeordneten Container zurück. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer) |
PrecedenceConstraints |
Ruft die Auflistung der PrecedenceConstraint-Objekte ab. Dieses Feld ist schreibgeschützt. |
Project |
Ruft das dem Paket zugeordnete angegebene Projekt ab oder legt es fest. |
Properties |
Ruft die Auflistung des DtsProperties-Objekts für das Paket ab. |
ProtectionLevel |
Ruft die Schutzebene für das Paket ab. |
SafeRecursiveProjectPackageExecution |
Ruft einen Wert ab, der angibt, ob die rekursive Ausführung des Pakets sicher ist, oder legt ihn fest. |
SaveCheckpoints |
Ruft einen Wert ab, der angibt, ob das Paket bei der Paketausführung Prüfpunkte verwendet, oder legt ihn fest. |
Site |
Ruft die Site für den Container ab oder legt sie fest. (Geerbt von DtsContainer) |
StartTime |
Gibt die Uhrzeit zurück, zu der der Container die Ausführung gestartet hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
StopTime |
Gibt die Uhrzeit zurück, zu der der Container die Ausführung beendet hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
SuppressConfigurationWarnings |
Ruft einen Wert ab, der angibt, ob die von Konfigurationen generierten Warnungen unterdrückt werden, oder legt ihn fest. |
SuspendRequired |
Ruft einen Booleschen Wert ab oder legt diesen fest, der angibt, ob Aufgaben angehalten werden sollen, wenn ein Haltepunkt auftritt. Dieser Wert wird von der Runtime-Engine für Tasks und Container festgelegt, wenn ein Breakpoint erreicht wird. (Geerbt von DtsContainer) |
TransactionOption |
Ruft einen DTSTransactionOption-Enumerationswert ab, der angibt, ob der Container an Transaktionen beteiligt ist, oder legt ihn fest. (Geerbt von DtsContainer) |
UpdateObjects |
Mitglied veraltet; siehe Hinweise. Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die erweiterbaren Objekte zum Paketladezeit aktualisiert werden können, wenn eine aktualisierte Version gefunden wird. |
VariableDispenser |
Gibt ein VariableDispenser-Objekt zurück, damit die dem Container zugeordneten Variablen gesperrt werden können. (Geerbt von DtsContainer) |
Variables |
Gibt eine Auflistung zurück, die die diesem Container zugeordneten Variablen enthält. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
VersionBuild |
Ruft die Buildversion des Pakets ab. |
VersionComments |
Ruft die dem Paket zugeordneten Versionskommentare ab. |
VersionGUID |
Ruft die bei der anfänglichen Paketerstellung generierte, eindeutige Versions-GUID ab. Dieses Feld ist schreibgeschützt. |
VersionMajor |
Ruft die Hauptbuildversion des Pakets ab. |
VersionMinor |
Ruft die Nebenbuildversion des Pakets ab. |
Warnings |
Ruft die für das Paket festgelegte Auflistung von Warnungen ab. Dieses Feld ist schreibgeschützt. |
Methoden
AcceptBreakpointManager(BreakpointManager) |
Diese Methode wird von der Runtime-Engine aufgerufen, wenn ein Task oder Container erstellt wird, der an einen BreakpointManager-Manager übergeben wird, damit der Task Breakpoints erstellen, entfernen und deren Status überprüfen kann. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet. (Geerbt von DtsContainer) |
AddDataTapPoint(String, String, Int32, String) |
Fügen Sie einen Daten tippen punkt auf einem bestimmten Datenfluss und dem angegebenen Datenflusspfad hinzu. |
CheckSignature() |
Überprüft den Status der digitalen Signatur des Pakets. |
ComputeExpressions(Boolean) |
Berechnungsausdrücke des Paketobjekts. |
Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von DtsContainer) |
Equals(Object) |
Stellt fest, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject) |
Execute() |
Gibt eine DTSExecResult-Enumeration zurück, die Informationen zur erfolgreichen oder fehlerhaften Ausführung des Pakets enthält. |
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object) |
Führt die Anwendung, den Container oder das Paket als Teil eines Paketworkflows aus. (Geerbt von DtsContainer) |
ExportConfigurationFile(String) |
Erstellt eine XML-Datei, die alle bereitstellbaren Variablen im Paket enthält. |
FindReferencedObjects(Object) |
Gibt eine Enumeration von Verweisobjekten zurück. |
GetBreakpointTargets(IDTSBreakpointSite, Boolean) |
Gibt eine BreakpointTargets-Auflistung zurück. Abhängig von der Einstellung des |
GetExecutionPath() |
Gibt den Ausführungspfad des aktuellen Pakets zurück. |
GetExpression(String) |
Gibt einen Wert zurück, der den Ausdruck für die angegebene Eigenschaft enthält. Null bedeutet, dass kein Ausdruck zugewiesen wird. |
GetHashCode() |
Gibt den Hashcode für diese Instanz zurück. (Geerbt von DtsObject) |
GetObjectFromPackagePath(String, DtsProperty) |
Gibt eine Paketeigenschaft und das Objekt aus dem angegebenen Paketpfad zurück. |
GetPackagePath() |
Gibt einen Wert zurück, der den relativen Pfad zum Paketspeicherort enthält. |
ImportConfigurationFile(String) |
Lädt eine dem Paket zugeordnete Konfigurationsdatei. |
LoadFromXML(String, IDTSEvents) |
Lädt ein Paket und alle dazugehörigen Objekte, die im XML-Format im Speicher gespeichert wurden. Verwenden Sie die LoadPackage(String, IDTSEvents)-Methode, um ein auf der Festplatte gespeichertes Paket zu laden. |
LoadFromXML(XmlNode, IDTSEvents) |
Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode. (Geerbt von DtsContainer) |
LoadUserCertificateByHash(Byte[]) |
Lädt das Zertifikat für das Paket nach dem Zertifikathash. |
LoadUserCertificateByName(String) |
Lädt das Zertifikat für das Paket nach dem Zertifikatnamen. |
ProcessConfiguration(String, Object) |
Gibt die Konfigurationsinformationen für ein Paket und die dazugehörigen Objekte an. |
RegenerateID() |
Erstellt einen neuen GUID für das Paket und aktualisiert die Paket-ID. |
ResumeExecution() |
Setzt die Taskausführung nach einer Unterbrechung fort. Die Runtime-Engine setzt die Ausführung des Tasks oder Containers fort. (Geerbt von DtsContainer) |
SaveToXML(String, IDTSEvents) |
Speichert das Paket in einem XML-Format im Arbeitsspeicher. Verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode, um ein Paket als XML-Datei auf der Festplatte zu speichern. |
SaveToXML(XmlDocument, XmlNode, IDTSEvents) |
Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode. (Geerbt von DtsContainer) |
SetExpression(String, String) |
Weist der Eigenschaft den angegebenen Ausdruck zu. Geben Sie null an, um einen vorhandenen Ausdruck aus der Eigenschaft zu entfernen. |
SetWrappedExecutable(IDTSExecutable100) |
Gibt das umschlossene ausführbare Objekt zurück. (Geerbt von EventsProvider) |
SuspendExecution() |
Wird aufgerufen, wenn das ausführbare Element angehalten werden muss. Diese Methode wird von der Runtime-Engine aufgerufen. (Geerbt von DtsContainer) |
Validate(Connections, Variables, IDTSEvents, IDTSLogging) |
Der Container kann feststellen, ob er ungültige Einstellungen enthält, die eine erfolgreiche Ausführung verhindern. (Geerbt von DtsContainer) |
Ereignisse
Disposed |
Fügt einen Ereignishandler hinzu, der auf das Disposed-Ereignis für die Komponente lauscht. (Geerbt von DtsContainer) |