DacPackage Klasse

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 Datenebenenanwendung enthält.

public sealed class DacPackage : IDisposable

type DacPackage = class
    interface IDisposable

Public NotInheritable Class DacPackage
Implements IDisposable

Vererbung: Object
DacPackage

Implementiert: IDisposable

Eigenschaften

Name	Beschreibung
Description	Rufen Sie eine optionale Zusammenfassung dieses Pakets ab.
Name	Bezeichner für dieses Paket abrufen.
PostDeploymentScript	Abrufen von Datenstrom zum Lesen und Schreiben von Skripts, die nach der Bereitstellung des Schemas in diesem Paket ausgeführt werden.
PreDeploymentScript	Abrufen von Datenstrom zum Lesen und Schreiben von Skripts, die vor der Bereitstellung des in diesem Paket enthaltenen Schemas ausgeführt werden.
Version	Abrufen von Versionsinformationen für dieses Paket.
VersionPrefix	Abrufen von Versionspräfixinformationen für die Paketversion Ex: VersionPrefix ist "Vorschau" für Die Vorschauversion und "" für die veröffentlichte Version

Methoden

Name	Beschreibung
Dispose()	Geben Sie die Ressourcen frei, die von dieser Instanz gehalten werden.
Load(Stream, DacSchemaModelStorageType, FileAccess)	Laden eines Pakets aus dem angegebenen Stream.
Load(Stream, DacSchemaModelStorageType)	Laden eines Pakets aus dem angegebenen Stream.
Load(Stream)	Laden eines Pakets aus dem angegebenen Stream.
Load(String, DacSchemaModelStorageType, FileAccess)	Laden sie eine paketdatei, die durch `fileName`.
Load(String, DacSchemaModelStorageType)	Laden sie eine paketdatei, die durch `fileName`.
Load(String)	Laden sie eine paketdatei, die durch `fileName`.
Unpack(String)	Platzieren Sie den Inhalt dieses Pakets in das durch `directoryPath`.

Erweiterungsmethoden

Name	Beschreibung
GetCollationString(DacPackage)	Gibt die Datenbanksortierung für das Paket zurück.
IsLedgerOn(DacPackage)	Darstellung des Artefakts, das die Definition einer Datenebenenanwendung enthält.
UpdateModel(DacPackage, TSqlModel, PackageMetadata)	Aktualisiert das Modell in einem DacPackage, wobei das aktuelle Modell durch ein neues ersetzt wird. Vor dem Aktualisieren wird das Modell überprüft, und wenn Fehler aufgetreten sind, wird ein DacServicesException Fehler ausgelöst. Wenn Anrufer Warnungen sowie Fehler blockieren möchten, müssen sie das Modell überprüfen, indem sie aufrufen Validate() und überprüfen, ob Fehler oder Warnungen in den zurückgegebenen Nachrichten enthalten sind. Hinweis: Nur das Modell wird ersetzt – alle anderen Artefakte wie Umgestaltungsprotokoll, Skript vor der Bereitstellung, Skript nach der Bereitstellung und Mitwirkendenartefakte werden nicht geändert. Wenn eines dieser Artefakte auf Elemente angewiesen ist, die sich nicht mehr im aktualisierten Modell befinden, schlägt die Bereitstellung möglicherweise fehl. Es liegt in der Verantwortung des Aufrufers, sicherzustellen, dass diese Artefakte mit dem neuen Modell konsistent sind. Die Package API kann verwendet werden, um andere Artefakte wie das Umgestaltungsprotokoll und Skripts zu aktualisieren und mit dem aktualisierten Modell konsistent zu halten. Diese Artefakte werden als Paketteile gespeichert und durch ihren URI identifiziert. Paketteile können mithilfe GetParts()von Weitere Informationen zum Aktualisieren von Paketteilen finden Sie in der Package API.

Name

Beschreibung

GetCollationString(DacPackage)

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

IsLedgerOn(DacPackage)

Darstellung des Artefakts, das die Definition einer Datenebenenanwendung enthält.

UpdateModel(DacPackage, TSqlModel, PackageMetadata)

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

Vor dem Aktualisieren wird das Modell überprüft, und wenn Fehler aufgetreten sind, wird ein DacServicesException Fehler ausgelöst. Wenn Anrufer Warnungen sowie Fehler blockieren möchten, müssen sie das Modell überprüfen, indem sie aufrufen Validate() und überprüfen, ob Fehler oder Warnungen in den zurückgegebenen Nachrichten enthalten sind.

Hinweis: Nur das Modell wird ersetzt – alle anderen Artefakte wie Umgestaltungsprotokoll, Skript vor der Bereitstellung, Skript nach der Bereitstellung und Mitwirkendenartefakte werden nicht geändert. Wenn eines dieser Artefakte auf Elemente angewiesen ist, die sich nicht mehr im aktualisierten Modell befinden, schlägt die Bereitstellung möglicherweise fehl. Es liegt in der Verantwortung des Aufrufers, sicherzustellen, dass diese Artefakte mit dem neuen Modell konsistent sind. Die Package API kann verwendet werden, um andere Artefakte wie das Umgestaltungsprotokoll und Skripts zu aktualisieren und mit dem aktualisierten Modell konsistent zu halten. Diese Artefakte werden als Paketteile gespeichert und durch ihren URI identifiziert. Paketteile können mithilfe GetParts()von Weitere Informationen zum Aktualisieren von Paketteilen finden Sie in der Package API.

Gilt für: