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.
Repräsentiert den Paketcontainer. 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 weiterer Container, Verbindungen, Aufgaben, Transformationen, Variablen, Konfigurationen und Prärangenzbeschränkungen. Pakete können programmatisch erstellt werden oder mit dem grafischen Werkzeug SSIS Designer. Pakete können an verschiedenen Orten gespeichert werden, einschließlich Microsoft SQL Server oder einer XML-Datei.
Weitere Informationen zu Paketen finden Sie unter Integration Services (SSIS) Pakete.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Package() |
Initialisiert eine neue Instanz der Package-Klasse. |
Felder
| Name | Beschreibung |
|---|---|
| m_executable |
Die ausführbare Datei. (Geerbt von Executable) |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CertificateContext |
Erhält oder setzt das X.509-Zertifikatsobjekt für das Paket. |
| CertificateObject |
Erhält oder setzt das X.509-Zertifikatsobjekt für das Paket. |
| CheckpointFileName |
Erhält oder setzt den Namen der Datei, die die Checkpoint-Informationen erfasst, was einen Neustart eines Pakets ermöglicht. |
| CheckpointUsage |
Erhält oder setzt einen Wert, der angibt, ob oder wann ein Paket neu gestartet wird. |
| CheckSignatureOnLoad |
Erhält oder setzt einen Wert, der angibt, ob die digitale Signatur beim Laden eines Pakets überprüft wird. |
| Configurations |
Erhält die Sammlung der Konfigurationen für das Paket. Ein Paket kann mit mehr als einer Konfiguration verbunden sein. Diese Eigenschaft ist schreibgeschützt. |
| Connections |
Erhält die Sammlung der Verbindungsmanager für das Paket. |
| CreationDate |
Erhält oder setzt das Datum und die Uhrzeit, an der das Paket erstellt wurde. |
| CreationName |
Gibt die Zeichenkette zurück, mit der eine Instanz des DtsContainer Objekts erstellt wird. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| CreatorComputerName |
Erhält oder setzt den Namen des Computers, auf dem das Paket erstellt wurde. |
| CreatorName |
Erhält oder setzt den Namen der Person, die das Paket erstellt hat. |
| DebugMode |
Erhält oder setzt einen Boolean, der anzeigt, ob das DtsContainer Objekt im Debug-Modus ist und ob es das OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) Ereignis während des Laufens auslösen sollte. (Geerbt von DtsContainer) |
| DelayValidation |
Erhält oder setzt einen Boolean, der angibt, ob die Validierung der Aufgabe bis zur Laufzeit verzögert wird. Der Standardwert ist „falsch“. (Geerbt von DtsContainer) |
| Description |
Erhält oder setzt die Beschreibung des DtsContainer Objekts. (Geerbt von DtsContainer) |
| DesignEvents |
Erhält oder setzt an IDTSEvents , das anzeigt, ob der Designer oder ein anderer Drittanbieter-Client während der Entwurfszeit Ereignisse erhalten soll. |
| DesignTimeProperties |
Erhält oder setzt die Designzeit-Eigenschaften eines Pakets, wie z. B. Layout-Informationen. |
| Disable |
Ein Boolean, der anzeigt, ob das DtsContainer Objekt deaktiviert ist. (Geerbt von DtsContainer) |
| DisableEventHandlers |
Erhält oder setzt einen Boolean, der anzeigt, ob die Ereignis-Handler auf der Aufgabe deaktiviert sind. (Geerbt von EventsProvider) |
| DumpDescriptor |
Gib an, wann eine Dump-Datei generiert werden soll. |
| DumpOnAnyError |
Geben Sie an, ob eine Dump-Datei generiert werden soll, wenn während der Paketausführung ein Fehler auftritt. |
| EnableConfigurations |
Erhält oder setzt einen Wert, der angibt, ob das Paket Konfigurationen lädt. |
| EnableDump |
Gib an, ob die Erzeugung der Dump-Datei aktiviert ist. |
| EncryptCheckpoints |
Erhält oder setzt einen Wert, der angibt, ob die Checkpoint-Dateien verschlüsselt sind. |
| Errors |
Erhält die Sammlung der mit dem Paket verbundenen Fehler. Dieses Feld ist schreibgeschützt. |
| EventHandlers |
Gibt eine Sammlung von Event Handler-Objekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider) |
| EventInfos |
Gibt eine Sammlung von EventInfo Objekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider) |
| Executables |
Erhält die Sammlung der ausführbaren Objekte, die im Paket enthalten sind und Teil des Paket-Workflows sind. |
| ExecutionDuration |
Gibt einen Wert zurück, der die Zeit angibt, die der Container in Millisekunden für die Ausführung verbracht hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| ExecutionResult |
Gibt einen Wert zurück, der den Erfolg oder das Misserfolg der Ausführung des Objekts DtsContainer anzeigt. (Geerbt von DtsContainer) |
| ExecutionStatus |
Gibt einen Wert zurück, der den aktuellen Status der Ausführung des DtsContainer Objekts zum Zeitpunkt des Aufrufs angibt. (Geerbt von DtsContainer) |
| ExtendedProperties |
Er bekommt die ExtendedProperties Sammlung für das Paket. |
| FailPackageOnFailure |
Erhält oder setzt einen Wert, der anzeigt, ob das Paket fehlschlägt, wenn eine Aufgabe oder Komponente im Paket ausfällt. |
| FailParentOnFailure |
Erhält oder setzt ein |
| ForcedExecutionValue |
Wenn die Eigenschaft ForceExecutionValue auf True gesetzt ist, erhält oder setzt sie einen Wert, der den optionalen Ausführungswert angibt, den das Paket zurückgibt. (Geerbt von DtsContainer) |
| ForceExecutionResult |
Erhält oder setzt einen DTSForcedExecResult Aufzählungswert, der das erzwungene Ausführungsergebnis des Containers angibt. (Geerbt von DtsContainer) |
| ForceExecutionValue |
Erhält oder setzt einen Boolean, der angibt, ob der Ausführungswert des Containers gezwungen werden soll, einen bestimmten Wert zu enthalten. (Geerbt von DtsContainer) |
| HasExpressions |
Erhält einen Wert, der angibt, ob das Paket Ausdrücke enthält. |
| ID |
Gibt die ID zurück, die ein GUID ist, der DtsContainer. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer) |
| IgnoreConfigurationsOnLoad |
Erhält oder setzt einen Wert, der anzeigt, ob das Paket Konfigurationen beim Laden des Pakets ignoriert. |
| InteractiveMode |
Erhält oder setzt einen Wert, der angibt, ob die Aufgaben während der Ausführung Benutzeroberflächenobjekte anzeigen sollen. |
| IsDefaultLocaleID |
Ein Boolean, der angibt, ob der Container den Standardstandort verwendet. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| IsolationLevel |
Erhält oder setzt das Isolationsniveau der Transaktion im Objekt DtsContainer . (Geerbt von DtsContainer) |
| LocaleID |
Erhält oder setzt eine Ganzzahl, 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 |
Erhält oder setzt einen gültigen Wert aus der DTSLoggingMode Aufzählung, der den Logging-Modus des Containers angibt. (Geerbt von DtsContainer) |
| LoggingOptions |
Gibt ein Objekt zurück, das Eigenschaften enthält, die die Filter- und Logging-Ressource für Container anzeigen. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| LogProviders |
Erhält die Sammlung der Log-Anbieter, die mit dem Paket verbunden sind. |
| MaxConcurrentExecutables |
Erhält oder setzt die Anzahl der Threads, die ein Paket erstellen kann. |
| MaximumErrorCount |
Erhält oder setzt einen Integer-Wert, der die maximale Anzahl von Fehlern angibt, die auftreten können, bevor das DtsContainer Objekt aufhört. (Geerbt von DtsContainer) |
| Name |
Dient zum Abrufen oder Festlegen des Namens der DtsContainer. (Geerbt von DtsContainer) |
| OfflineMode |
Erhält oder setzt einen Wert, der anzeigt, ob das Paket im Offline-Modus arbeitet. |
| PackagePassword |
Legt den Wert des Passworts für das Paket fest. Diese Eigenschaft ist nur schreibbar. |
| PackagePriorityClass |
Spezifiziert die Win32-Thread-Prioritätsklasse des Paketthreads. |
| PackageType |
Spezifiziert einen Wert, der das Tool identifiziert, das das Paket erstellt hat. |
| PackageUpgradeOptions |
Erhält oder stellt die Upgrade-Optionen für das Paket ein. |
| Parameters |
Erhält die Parametersammlung für das Paket. |
| Parent |
Gibt den Elterncontainer zurück. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer) |
| PrecedenceConstraints |
Ruft die Auflistung der PrecedenceConstraint Objekte ab. Dieses Feld ist schreibgeschützt. |
| Project |
Erhält oder setzt das mit dem Paket zugeordnete Projekt. |
| Properties |
Erhält die Sammlung des DtsProperties Objekts für das Paket. |
| ProtectionLevel |
Er erhält den Schutzgrad auf dem Paket. |
| SafeRecursiveProjectPackageExecution |
Erhält oder setzt einen Wert, der angibt, ob die rekursive Ausführung des Pakets sicher ist. |
| SaveCheckpoints |
Erhält oder setzt einen Wert, der angibt, ob das Paket während der Paketausführung Checkpoints verwendet. |
| Site |
Bekommt oder setzt die Seite für den Container. (Geerbt von DtsContainer) |
| StartTime |
Gibt die Zeit zurück, zu der der Container mit der Ausführung begonnen hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| StopTime |
Gibt die Zeit zurück, in der der Container die Ausführung beendet hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| SuppressConfigurationWarnings |
Erhält oder setzt einen Wert, der angibt, ob die durch Konfigurationen erzeugten Warnungen unterdrückt werden. |
| SuspendRequired |
Erhält oder setzt einen Boolean, der anzeigt, ob Aufgaben ausgesetzt werden sollten, wenn sie auf einen Breakpoint stoßen. Dieser Wert wird von der Laufzeit-Engine für Aufgaben und Container festgelegt, wenn ein Breakpoint erreicht wird. (Geerbt von DtsContainer) |
| TransactionOption |
Erhält oder setzt einen DTSTransactionOption Enumerationswert, der angibt, ob der Container an Transaktionen teilnimmt. (Geerbt von DtsContainer) |
| UpdateObjects |
Mitglied veraltet; siehe Bemerkungen. Erhält oder setzt einen Wert, der angibt, ob die erweiterbaren Objekte beim Laden des Pakets aktualisiert werden können, falls eine aktualisierte Version gefunden wird. |
| VariableDispenser |
Gibt ein VariableDispenser Objekt zurück, sodass mit dem Container zugeordnete Variablen gesperrt werden können. (Geerbt von DtsContainer) |
| Variables |
Gibt eine Sammlung zurück, die die mit diesem Container verbundenen Variablen enthält. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| VersionBuild |
Er bekommt die Build-Version des Pakets. |
| VersionComments |
Es bekommt die Versionskommentare, die mit dem Paket verbunden sind. |
| VersionGUID |
Erhält die Versions-GUID, die beim ersten Erstellen des Pakets generiert wird. Dieses Feld ist schreibgeschützt. |
| VersionMajor |
Er bekommt die Hauptversion des Pakets. |
| VersionMinor |
Er bekommt die Minor-Build-Version des Pakets. |
| Warnings |
Er bekommt die Warnsammlung, die auf der Verpackung steht. Dieses Feld ist schreibgeschützt. |
Methoden
| Name | Beschreibung |
|---|---|
| AcceptBreakpointManager(BreakpointManager) |
Diese Methode wird von der Laufzeit-Engine aufgerufen, wenn eine Aufgabe oder ein Container erstellt wird, und übermittelt ihr einen BreakpointManager Manager, damit die Aufgabe Breakpoints erstellen, entfernen und überprüfen kann. Diese Methode wird von der Laufzeit aufgerufen und im Code nicht verwendet. (Geerbt von DtsContainer) |
| AddDataTapPoint(String, String, Int32, String) |
Füge einen Daten-Tap-Punkt auf einen gegebenen Datenfluss und einen bestimmten Datenflusspfad hinzu. |
| CheckSignature() |
Überprüft den Status der digitalen Signatur des Pakets. |
| ComputeExpressions(Boolean) |
Berechnen Sie Ausdrücke des Paketobjekts. |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (Geerbt von DtsContainer) |
| Equals(Object) |
Bestimmt, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject) |
| Execute() |
Gibt eine DTSExecResult Aufzählung zurück, die Informationen über den Erfolg oder Misserfolg der Paketausführung enthält. |
| Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object) |
Führt die Anwendung, den Container oder das Paket als Teil eines Paket-Workflows aus. (Geerbt von DtsContainer) |
| ExportConfigurationFile(String) |
Erstellt eine XML-Datei, die alle deployablen Variablen im Paket enthält. |
| FindReferencedObjects(Object) |
Gibt eine Referenzobjekt-Enumeration zurück. |
| GetBreakpointTargets(IDTSBreakpointSite, Boolean) |
Gibt eine BreakpointTargets Auflistung zurück. Je nach Parametereinstellung |
| 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 diesen instance 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 Paketstandort enthält. |
| ImportConfigurationFile(String) |
Lädt eine Konfigurationsdatei, die dem Paket zugeordnet ist. |
| LoadFromXML(String, IDTSEvents) |
Lädt ein Paket und alle seine Objekte, die im XML-Format im Speicher gespeichert wurden. Um ein auf der Festplatte gespeichertes Paket zu laden, verwenden Sie die Methode LoadPackage(String, IDTSEvents) . |
| LoadFromXML(XmlNode, IDTSEvents) |
Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein als .xmlgespeichertes Paket zu laden, verwenden Sie die Methode LoadPackage(String, IDTSEvents) . (Geerbt von DtsContainer) |
| LoadUserCertificateByHash(Byte[]) |
Lädt das Zertifikat für das Paket gemäß dem Zertifikatshash. |
| LoadUserCertificateByName(String) |
Lädt das Zertifikat für das Paket entsprechend dem Zertifikatsnamen. |
| ProcessConfiguration(String, Object) |
Spezifiziert die Konfigurationsinformationen für ein Paket und seine Objekte. |
| RegenerateID() |
Erstellt einen neuen GUID für das Paket und aktualisiert die Paket-ID. |
| ResumeExecution() |
Setzt die Ausführung der Aufgabe nach der Pause fort. Die Aufgabe oder der Container wird von der Laufzeit-Engine fortgesetzt. (Geerbt von DtsContainer) |
| SaveToXML(String, IDTSEvents) |
Speichert das Paket im XML-Format im Speicher. Um ein Paket als .xml auf die Festplatte zu speichern, verwenden Sie die Methode SaveToXml(String, Package, IDTSEvents) . |
| SaveToXML(XmlDocument, XmlNode, IDTSEvents) |
Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein Paket als .xmlzu speichern, verwenden Sie die Methode SaveToXml(String, Package, IDTSEvents) . (Geerbt von DtsContainer) |
| SetExpression(String, String) |
Weist den angegebenen Ausdruck der Eigenschaft zu. Geben Sie null an, um einen bestehenden Ausdruck aus der Eigenschaft zu entfernen. |
| SetWrappedExecutable(IDTSExecutable100) |
Gibt das gewickelte ausführbare Objekt zurück. (Geerbt von EventsProvider) |
| SuspendExecution() |
Wird aufgerufen, wenn die ausführbare Datei suspendiert werden muss. Diese Methode wird von der Laufzeit-Engine aufgerufen. (Geerbt von DtsContainer) |
| Validate(Connections, Variables, IDTSEvents, IDTSLogging) |
Ermöglicht es dem Container zu bestimmen, ob er ungültige Einstellungen enthält, die eine erfolgreiche Ausführung verhindern. (Geerbt von DtsContainer) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Fügt einen Ereignishandler hinzu, um auf das Ereignis in der Disposed Komponente zu lauschen. (Geerbt von DtsContainer) |