Método DacPackageExtensions.UpdateModel

Artigo
07/27/2015

Atualiza o modelo em um DacPackage, substituindo o modelo atual por um novo. Antes da atualização, o modelo será validado e, se forem encontrados erros, uma DacServicesException será lançada. Se os chamadores desejam bloquear avisos, como erros, eles devem validar o modelo chamando Validate() e verificando se há erros ou avisos incluídos nas mensagens retornadas. Observação: somente o modelo é substituído; todos os outros artefatos, como log de refatoração, script de pré-implantação e artefatos de colaboração, não são alterados. Se algum desses artefatos se basear em elementos que não estão mais no modelo atualizado, a implantação poderá apresentar falha. É responsabilidade do chamador garantir que esses artefatos estejam consistentes com o novo modelo. A API do Package pode ser usada para atualizar outros artefatos, como o log de refatoração e os scripts, e para mantê-los consistentes com o modelo atualizado. Esses artefatos são armazenados como partes do pacote e são identificados por seu URI. As partes do pacote podem ser examinadas por meio de GetParts(). Consulte a API do Package para obter informações adicionais sobre como atualizar as partes do pacote.

Namespace: Microsoft.SqlServer.Dac
Assembly: Microsoft.SqlServer.Dac.Extensions (em Microsoft.SqlServer.Dac.Extensions.dll)

Sintaxe

'Declaração
<ExtensionAttribute> _
Public Shared Sub UpdateModel ( _
    dacPackage As DacPackage, _
    newModel As TSqlModel, _
    packageMetadata As PackageMetadata _
)
'Uso
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
)

Parâmetros

dacPackage
Tipo: Microsoft.SqlServer.Dac.DacPackage
DacPackage a ser atualizado

newModel
Tipo: Microsoft.SqlServer.Dac.Model.TSqlModel
O TSqlModel que representa o modelo a ser salvo no pacote.

packageMetadata
Tipo: Microsoft.SqlServer.Dac.PackageMetadata
O PackageMetadata que descreve o nome, a versão e a descrição a ser usada no DacPackage, ou nulo se as informações do pacote tiverem que permanecer inalteradas.

Observação sobre o uso

No Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo DacPackage. Quando usar uma sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte b8020aae-374d-46a9-bcb7-8cc2390b93b6 ou 175ce3ff-9bbf-4e64-8421-faeb81a0bb51.

Exceções

Exceção	Condição
DacServicesException	Se o DacPackage contiver dados.
DacServicesException	Se houver algum erro ao salvar o modelo no pacote, incluindo erros de validação do modelo.
DacServicesException	Se dacPackage não tiver sido carregado com ReadWrite.
ArgumentNullException	Se os parâmetros dacPackage ou newModel forem nulos.

Consulte também

Referência

DacPackageExtensions Classe

Namespace Microsoft.SqlServer.Dac

Partilhar via