DacPackage Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dac

Assembly:: Microsoft.SqlServer.Dac.dll

Paket:: Microsoft.SqlServer.DacFx.x64 v140.3881.1

Paket:: Microsoft.SqlServer.DacFx v150.5282.3

Paket:: Microsoft.SqlServer.DacFx v160.6161.0

Paket:: Microsoft.SqlServer.DacFx v162.2.111

Paket:: Microsoft.Data.Tools.Msbuild v10.0.61804.210

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.

Darstellung des Artefakts, das die Definition einer Anwendung auf Datenebene enthält.

public sealed class DacPackage : IDisposable

type DacPackage = class
    interface IDisposable

Public NotInheritable Class DacPackage
Implements IDisposable

Vererbung: Object
DacPackage

Implementiert: IDisposable

Eigenschaften

Description	Ruft eine optionale Zusammenfassung dieses Pakets ab.
Name	Ruft den Bezeichner für dieses Paket ab.
PostDeploymentScript	Ruft den Stream ab, der zum Lesen und Schreiben von Skriptcode verwendet wird, der nach dem Bereitstellen des Schemas in diesem Paket ausgeführt wird.
PreDeploymentScript	Ruft den Stream ab, der zum Lesen und Schreiben von Skriptcode verwendet wird, der vor dem Bereitstellen des Schemas in diesem Paket ausgeführt wird.
Version	Ruft Versionsinformationen für dieses Paket ab.
VersionPrefix	Abrufen von Versionspräfixinformationen für die Paketversion: VersionPrefix ist "Vorschau" für die Vorschauversion und "" für die veröffentlichte Version

Methoden

Dispose()	Gibt die durch diese Instanz belegten Ressourcen frei.
Load(Stream)	Lädt ein Paket aus dem angegebenen Stream.
Load(Stream, DacSchemaModelStorageType)	Lädt ein Paket aus dem angegebenen Stream.
Load(Stream, DacSchemaModelStorageType, FileAccess)	Lädt ein Paket aus dem angegebenen Stream.
Load(String)	Lädt eine durch `fileName` angegebene Paketdatei.
Load(String, DacSchemaModelStorageType)	Lädt eine durch `fileName` angegebene Paketdatei.
Load(String, DacSchemaModelStorageType, FileAccess)	Lädt eine durch `fileName` angegebene Paketdatei.
Unpack(String)	Platzieren Sie den Inhalt dieses Pakets in dem von `directoryPath`angegebenen Verzeichnis.

Erweiterungsmethoden

UpdateModel(DacPackage, TSqlModel, PackageMetadata)

Aktualisiert das Modell in einem DacPackage, das aktuelle Modell durch ein neues ersetzt.

Vor dem Aktualisieren wird das Modell validiert und, wenn Fehler auftreten, wird eine DacServicesException ausgelöst. Wenn Aufrufer Warnungen sowie Fehler blockieren möchten, müssen sie das Modell durch Aufrufen von Validate() validieren und überprüfen, ob in den zurückgegebenen Meldungen Fehler oder Warnungen enthalten sind.

Hinweis: Nur das Modell wird ersetzt – alle übrigen Artefakte wie Umgestaltungsprotokoll, Skript vor der Bereitstellung, Skript nach der Bereitstellung und Contributor-Artefakte werden nicht geändert. Wenn sich Artefakte auf Elemente stützen, die im aktualisierten Modell nicht mehr vorhanden sind, kann die Bereitstellung fehlschlagen. Der Aufrufer muss sicherstellen, dass die betreffenden Artefakte mit dem neuen Modell konsistent sind. Die Package-API kann verwendet werden, um andere Artefakte wie das Umgestaltungsprotokoll und Skripte zu aktualisieren und die Konsistenz mit dem aktualisierten Modell zu gewährleisten. Diese Artefakte werden als Paketteile gespeichert und anhand ihres URIs identifiziert. Paketteile könnten mit GetParts() untersucht werden. Bitte beziehen Sie sich auf die Package-API für weitere Informationen zum Aktualisieren von Paketteilen.

GetCollationString(DacPackage)

Gibt die Datenbanksortierung für das Paket zurück.

IsLedgerOn(DacPackage)