Méthode DacPackageExtensions.UpdateModel

Article
07/23/2015

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.

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

Syntaxe

'Déclaration
<ExtensionAttribute> _
Public Shared Sub UpdateModel ( _
    dacPackage As DacPackage, _
    newModel As TSqlModel, _
    packageMetadata As PackageMetadata _
)
'Utilisation
Dim dacPackage As DacPackage 
Dim newModel As TSqlModel 
Dim packageMetadata As PackageMetadata 

dacPackage.UpdateModel(newModel, _
    packageMetadata)

public static void UpdateModel(
    this DacPackage dacPackage,
    TSqlModel newModel,
    PackageMetadata packageMetadata
)

[ExtensionAttribute]
public:
static void UpdateModel(
    DacPackage^ dacPackage, 
    TSqlModel^ newModel, 
    PackageMetadata^ packageMetadata
)

static member UpdateModel : 
        dacPackage:DacPackage * 
        newModel:TSqlModel * 
        packageMetadata:PackageMetadata -> unit

public static function UpdateModel(
    dacPackage : DacPackage, 
    newModel : TSqlModel, 
    packageMetadata : PackageMetadata
)

Paramètres

dacPackage
Type : Microsoft.SqlServer.Dac.DacPackage
DacPackage à mettre à jour

newModel
Type : Microsoft.SqlServer.Dac.Model.TSqlModel
TSqlModel représentant le modèle à enregistrer dans le package.

packageMetadata
Type : Microsoft.SqlServer.Dac.PackageMetadata
PackageMetadata indiquant le nom, la version et la description à utiliser pour le DacPackage, ou une valeur Null si les informations de package doivent rester inchangées.

Remarque relative à l'utilisation

En Visual Basic et C#, vous pouvez appeler cette méthode comme méthode d'instance sur tout objet de type DacPackage. Lorsque vous utilisez la syntaxe de la méthode d'instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d'informations, consultez b8020aae-374d-46a9-bcb7-8cc2390b93b6 ou 175ce3ff-9bbf-4e64-8421-faeb81a0bb51.

Exceptions

Exception	Condition
DacServicesException	Si le DacPackage contient des données.
DacServicesException	En présence d'erreurs durant l'enregistrement du modèle dans le package, y compris des erreurs lors de la validation du modèle.
DacServicesException	Si le dacPackage n'a pas été chargé avec ReadWrite.
ArgumentNullException	Si les paramètres dacPackage ou newModel ont la valeur Null.

Voir aussi

Référence

DacPackageExtensions Classe

Espace de noms Microsoft.SqlServer.Dac

Partager via