DacPackageExtensions.UpdateModel Método
Actualiza el modelo de un DacPackage, reemplazando el modelo actual con uno nuevo. Antes de actualizarse, se validará el modelo y se producirá DacServicesException si se encuentra algún error. Si los autores de llamada desean bloquear la operación si se producen advertencias y errores, deben validar el modelo llamando a Validate() y comprobando si se incluye algún error o alguna advertencia en los mensajes devueltos. Nota: solo se reemplaza el modelo; todos los demás artefactos como el registro de refactorización, el script anterior a la implementación, el script posterior a la implementación y el colaborador no cambian. Si alguno de estos artefactos emplea elementos que ya no están en el modelo actualizado, se puede producir un error en la implementación. Es responsabilidad del autor de la llamada asegurarse de que estos artefactos son coherentes con el nuevo modelo. Se puede usar la API Package para actualizar otros artefactos como el registro de refactorización y los scripts, y hacer que sigan siendo coherentes con el modelo actualizado. Estos artefactos se almacenan como elementos del paquete y se identifican por su URI. Los elementos del paquete se pueden examinar con GetParts(). Vea la API Package para obtener más información sobre cómo actualizar elementos del paquete.
Espacio de nombres: Microsoft.SqlServer.Dac
Ensamblado: Microsoft.SqlServer.Dac.Extensions (en Microsoft.SqlServer.Dac.Extensions.dll)
Sintaxis
'Declaración
<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 que se va a actualizar
- newModel
Tipo: Microsoft.SqlServer.Dac.Model.TSqlModel
TSqlModel que representa el modelo que se va a guardar en el paquete.
- packageMetadata
Tipo: Microsoft.SqlServer.Dac.PackageMetadata
PackageMetadata que escribe el nombre, la versión y la descripción que se usarán para DacPackage, o NULL si la información del paquete debe seguir siendo la misma.
Nota de uso
En Visual Basic y C#, puede llamar a este método como un método de instancia en cualquier objeto del tipo DacPackage. Cuando utilice la sintaxis del método de instancia para llamar a este método, sáltese este parámetro primero. Para obtener más información, vea b8020aae-374d-46a9-bcb7-8cc2390b93b6 o 175ce3ff-9bbf-4e64-8421-faeb81a0bb51.
Excepciones
Excepción | Condición |
---|---|
DacServicesException | Si el DacPackage contiene datos. |
DacServicesException | Si se produce algún error al guardar el modelo en el paquete, incluidos errores de validación del modelo. |
DacServicesException | Si el dacPackage no se cargó con ReadWrite. |
ArgumentNullException | Si los parámetros dacPackage o newModel son NULL. |