DacPackageExtensions Classe

Définition

Fournit des méthodes d’extension pour prendre en charge la manipulation d’objets DacPackage. Ces méthodes d’extension fonctionnent sur un élément existant DacPackage

public static class DacPackageExtensions
type DacPackageExtensions = class
Public Module DacPackageExtensions
Héritage
DacPackageExtensions

Méthodes

Nom Description
BuildPackage(Stream, TSqlModel, PackageMetadata, PackageOptions)

Crée un package avec le package spécifié TSqlModel et l’enregistre dans le package spécifié Stream. En plus des autres artefacts, tels que le TSqlModeljournal de refactorisation et les contributeurs de déploiement, peuvent être spécifiés dans packageOptions.

BuildPackage(Stream, TSqlModel, PackageMetadata)

Crée un package avec le package spécifié TSqlModel et l’enregistre dans le package spécifié Stream.

BuildPackage(String, TSqlModel, PackageMetadata, PackageOptions)

Crée un package avec le package spécifié TSqlModel et l’enregistre à l’emplacement spécifié. En plus des autres artefacts, tels que le TSqlModeljournal de refactorisation et les contributeurs de déploiement, peuvent être spécifiés dans packageOptions.

BuildPackage(String, TSqlModel, PackageMetadata)

Crée un package avec le package spécifié TSqlModel et l’enregistre à l’emplacement spécifié.

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 à