DacPackage Classe

Définition

Espace de noms:: Microsoft.SqlServer.Dac

Assembly:: Microsoft.SqlServer.Dac.dll

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

Paquet:: Microsoft.SqlServer.DacFx v150.5282.3

Paquet:: Microsoft.SqlServer.DacFx v160.6161.0

Paquet:: Microsoft.SqlServer.DacFx v162.2.111

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représentation de l’artefact qui contient la définition d’une application de la couche Données.

public sealed class DacPackage : IDisposable

type DacPackage = class
    interface IDisposable

Public NotInheritable Class DacPackage
Implements IDisposable

Héritage: Object
DacPackage

Implémente: IDisposable

Propriétés

Nom	Description
Description	Obtenez un résumé facultatif de ce package.
Name	Obtenir l’identificateur de ce package.
PostDeploymentScript	Obtenez le flux utilisé pour lire et écrire un script exécuté après le déploiement du schéma contenu dans ce package.
PreDeploymentScript	Obtenez le flux utilisé pour lire et écrire un script exécuté avant de déployer le schéma contenu dans ce package.
Version	Obtenez des informations de version pour ce package.
VersionPrefix	Obtenir les informations de préfixe de version pour la version du package Ex : VersionPrefix sera « preview » pour la préversion et « » pour la version publiée

Méthodes

Nom	Description
Dispose()	Relâchez les ressources détenues par cette instance.
Load(Stream, DacSchemaModelStorageType, FileAccess)	Chargez un package à partir du package spécifié Stream.
Load(Stream, DacSchemaModelStorageType)	Chargez un package à partir du package spécifié Stream.
Load(Stream)	Chargez un package à partir du package spécifié Stream.
Load(String, DacSchemaModelStorageType, FileAccess)	Chargez un fichier de package spécifié par `fileName`.
Load(String, DacSchemaModelStorageType)	Chargez un fichier de package spécifié par `fileName`.
Load(String)	Chargez un fichier de package spécifié par `fileName`.
Unpack(String)	Placez le contenu de ce package dans le répertoire spécifié par `directoryPath`.

Méthodes d’extension

Nom	Description
GetCollationString(DacPackage)	Retourne le classement de base de données du package.
IsLedgerOn(DacPackage)	Représentation de l’artefact qui contient la définition d’une application de la couche Données.
UpdateModel(DacPackage, TSqlModel, PackageMetadata)	Met à jour le modèle dans un DacPackagemodèle en remplaçant le modèle actuel par un nouveau modèle. Avant la mise à jour, le modèle sera validé et si des erreurs sont rencontrées, un DacServicesException sera levée. Si les appelants souhaitent bloquer les avertissements ainsi que les erreurs, ils doivent valider le modèle en appelant Validate() et en vérifiant si des erreurs ou des avertissements sont inclus dans les messages retournés. Remarque : seul le modèle est remplacé : tous les autres artefacts tels que le journal de refactorisation, le script de prédéploiement, le script post-déploiement et les artefacts contributeurs ne sont pas modifiés. Si l’un de ces artefacts s’appuie sur des éléments qui ne sont plus dans le modèle mis à jour, le déploiement peut échouer. Il incombe à l’appelant de s’assurer que ces artefacts sont cohérents avec le nouveau modèle. L’API Package peut être utilisée pour mettre à jour d’autres artefacts tels que le journal de refactorisation et les scripts et les maintenir cohérents avec le modèle mis à jour. Ces artefacts sont stockés en tant que composants de package et sont identifiés par leur URI. Les parties de package peuvent être examinées à l’aide GetParts()de . Pour plus d’informations sur la mise à jour des composants de package, reportez-vous à l’API Package .

Nom

Description

GetCollationString(DacPackage)

Retourne le classement de base de données du package.

IsLedgerOn(DacPackage)

Représentation de l’artefact qui contient la définition d’une application de la couche Données.

UpdateModel(DacPackage, TSqlModel, PackageMetadata)

Met à jour le modèle dans un DacPackagemodèle en remplaçant le modèle actuel par un nouveau modèle.

Avant la mise à jour, le modèle sera validé et si des erreurs sont rencontrées, un DacServicesException sera levée. Si les appelants souhaitent bloquer les avertissements ainsi que les erreurs, ils doivent valider le modèle en appelant Validate() et en vérifiant si des erreurs ou des avertissements sont inclus dans les messages retournés.

Remarque : seul le modèle est remplacé : tous les autres artefacts tels que le journal de refactorisation, le script de prédéploiement, le script post-déploiement et les artefacts contributeurs ne sont pas modifiés. Si l’un de ces artefacts s’appuie sur des éléments qui ne sont plus dans le modèle mis à jour, le déploiement peut échouer. Il incombe à l’appelant de s’assurer que ces artefacts sont cohérents avec le nouveau modèle. L’API Package peut être utilisée pour mettre à jour d’autres artefacts tels que le journal de refactorisation et les scripts et les maintenir cohérents avec le modèle mis à jour. Ces artefacts sont stockés en tant que composants de package et sont identifiés par leur URI. Les parties de package peuvent être examinées à l’aide GetParts()de . Pour plus d’informations sur la mise à jour des composants de package, reportez-vous à l’API Package .

S’applique à