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 | |
---|---|---|
BuildPackage(Stream, TSqlModel, PackageMetadata) | Crée un package avec le TSqlModel spécifié et l'enregistre dans le Stream indiqué. | |
BuildPackage(String, TSqlModel, PackageMetadata) | Crée un package avec le TSqlModel spécifié et l'enregistre à l'emplacement indiqué. | |
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. | |
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. | |
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.