Partager via


Classe DacPackageExtensions

Fournit des méthodes pour prendre en charge la manipulation des objets DacPackage. Ces méthodes fonctionnent sur un DacPackage existant.

Hiérarchie d'héritage

System.Object
  Microsoft.SqlServer.Dac.DacPackageExtensions

Espace de noms :  Microsoft.SqlServer.Dac
Assembly :  Microsoft.SqlServer.Dac.Extensions (en Microsoft.SqlServer.Dac.Extensions.dll)

Syntaxe

'Déclaration
<ExtensionAttribute> _
Public NotInheritable Class DacPackageExtensions
'Utilisation
public static class DacPackageExtensions
[ExtensionAttribute]
public ref class DacPackageExtensions abstract sealed
[<AbstractClassAttribute>]
[<SealedAttribute>]
type DacPackageExtensions =  class end
public final class DacPackageExtensions

Le type DacPackageExtensions expose les membres suivants.

Méthodes

  Nom Description
Méthode publiqueMembre statique BuildPackage(Stream, TSqlModel, PackageMetadata) Crée un package avec le TSqlModel spécifié et l'enregistre dans le Stream indiqué.
Méthode publiqueMembre statique BuildPackage(String, TSqlModel, PackageMetadata) Crée un package avec le TSqlModel spécifié et l'enregistre à l'emplacement indiqué.
Méthode publiqueMembre statique BuildPackage(Stream, TSqlModel, PackageMetadata, PackageOptions) Crée un package avec le TSqlModel spécifié et l'enregistre dans le Stream indiqué.Outre le TSqlModel, d'autres artefacts, tels que le journal de refactorisation et les collaborateurs de déploiement, peuvent être spécifiés dans packageOptions.
Méthode publiqueMembre statique BuildPackage(String, TSqlModel, PackageMetadata, PackageOptions) Crée un package avec le TSqlModel spécifié et l'enregistre à l'emplacement indiqué.Outre le TSqlModel, d'autres artefacts, tels que le journal de refactorisation et les collaborateurs de déploiement, peuvent être spécifiés dans packageOptions.
Méthode publiqueMembre statique UpdateModel Met à jour le modèle dans un DacPackage, remplaçant ainsi le modèle actuel par un nouveau.Avant la mise à jour, une validation du modèle a lieu. Si des erreurs sont rencontrées, une DacServicesException est levée.Si des appelants souhaitent un blocage en cas d'avertissements et d'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é ; les autres artefacts, comme le journal de refactorisation, le script de prédéploiement, le script de post-déploiement et les artefacts de collaborateur ne sont pas modifiés.Si l'un de ces artefacts repose sur des éléments qui ne font plus partie du modèle mis à jour, le déploiement risque d'échouer.Il est de la responsabilité de 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, comme le journal de refactorisation et les scripts, et garantir leur cohérence avec le modèle mis à jour.Ces artefacts sont stockés en tant que parties de package et identifiés par leur URI.Les parties de package peuvent être examinées à l'aide de GetParts().Pour plus d'informations sur la mise à jour des parties de package, consultez l'API Package.

Haut de la page

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms Microsoft.SqlServer.Dac