DacPackageExtensions.UpdateModel Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dac

Ensamblado:

Microsoft.SqlServer.Dac.Extensions.dll

Paquete:

Microsoft.SqlServer.DacFx v162.2.111

Actualiza el modelo en un DacPackage, reemplazando el modelo actual por uno nuevo.

Antes de la actualización, se validará el modelo y se producirán DacServicesException errores. Si los autores de llamadas desean bloquear las advertencias, así como los errores, deben validar el modelo llamando Validate() a y comprobando si se incluyen errores o advertencias en los mensajes devueltos.

Nota: solo se reemplaza el modelo: no se modifican todos los demás artefactos, como el registro de refactorización, el script previo a la implementación, el script posterior a la implementación y los artefactos de colaborador. Si alguno de estos artefactos se basa en elementos que ya no están en el modelo actualizado, es posible que se produzca un error en la implementación. Es responsabilidad del autor de la llamada asegurarse de que estos artefactos son coherentes con el nuevo modelo. La Package API se puede usar para actualizar otros artefactos, como el registro de refactorización y los scripts, y mantenerlos coherentes con el modelo actualizado. Estos artefactos se almacenan como elementos del paquete y se identifican mediante su URI. Los elementos del paquete se pueden examinar mediante GetParts(). Consulte la API para obtener más información sobre cómo Package actualizar los elementos del paquete.

public static void UpdateModel(this Microsoft.SqlServer.Dac.DacPackage dacPackage, Microsoft.SqlServer.Dac.Model.TSqlModel newModel, Microsoft.SqlServer.Dac.PackageMetadata packageMetadata);

static member UpdateModel : Microsoft.SqlServer.Dac.DacPackage * Microsoft.SqlServer.Dac.Model.TSqlModel * Microsoft.SqlServer.Dac.PackageMetadata -> unit

<Extension()>
Public Sub UpdateModel (dacPackage As DacPackage, newModel As TSqlModel, packageMetadata As PackageMetadata)

Parámetros

dacPackage

DacPackage

DacPackage que se va a actualizar

newModel

TSqlModel

TSqlModel que representa el modelo que se va a guardar en el paquete.

packageMetadata

PackageMetadata

PackageMetadata describir el nombre, la versión y la descripción que se van a usar para DacPackage, o null si la información del paquete debe permanecer igual.

Excepciones

DacServicesException

dacPackage Si no se cargó con ReadWrite.

ArgumentNullException

Si los dacPackage parámetros o newModel son NULL.