DacPackageExtensions Classe

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dac

Assembly:

Microsoft.SqlServer.Dac.Extensions.dll

Pacchetto:

Microsoft.SqlServer.DacFx v162.2.111

Fornisce metodi di estensione per supportare la manipolazione degli oggetti DacPackage. Questi metodi di estensione funzionano su un oggetto esistente DacPackage

public static class DacPackageExtensions

type DacPackageExtensions = class

Public Module DacPackageExtensions

Ereditarietà

Object

DacPackageExtensions

Metodi

Nome	Descrizione
BuildPackage(Stream, TSqlModel, PackageMetadata, PackageOptions)	Crea un pacchetto con l'oggetto specificato TSqlModel e lo salva nell'oggetto specificato Stream. Oltre a TSqlModel, altri artefatti, ad esempio il log di refactoring e i collaboratori alla distribuzione, possono essere specificati in packageOptions.
BuildPackage(Stream, TSqlModel, PackageMetadata)	Crea un pacchetto con l'oggetto specificato TSqlModel e lo salva nell'oggetto specificato Stream.
BuildPackage(String, TSqlModel, PackageMetadata, PackageOptions)	Crea un pacchetto con l'oggetto specificato TSqlModel e lo salva nella posizione specificata. Oltre a TSqlModel, altri artefatti, ad esempio il log di refactoring e i collaboratori alla distribuzione, possono essere specificati in packageOptions.
BuildPackage(String, TSqlModel, PackageMetadata)	Crea un pacchetto con l'oggetto specificato TSqlModel e lo salva nella posizione specificata.
UpdateModel(DacPackage, TSqlModel, PackageMetadata)	Aggiorna il modello in un DacPackageoggetto , sostituendo il modello corrente con un nuovo modello. Prima dell'aggiornamento, il modello verrà convalidato e, se vengono rilevati errori, verrà generata un'eccezione DacServicesException . Se i chiamanti desiderano bloccare gli avvisi e gli errori, devono convalidare il modello chiamando Validate() e verificando se nei messaggi restituiti sono inclusi errori o avvisi. Nota: solo il modello viene sostituito: tutti gli altri artefatti, ad esempio il log di refactoring, lo script di pre-distribuzione, lo script di post-distribuzione e gli artefatti collaboratore non vengono modificati. Se uno di questi elementi si basa su elementi che non sono più presenti nel modello aggiornato, la distribuzione potrebbe non riuscire. È responsabilità del chiamante assicurarsi che questi artefatti siano coerenti con il nuovo modello. L'API Package può essere usata per aggiornare altri artefatti, ad esempio il log di refactoring e gli script e mantenerli coerenti con il modello aggiornato. Questi artefatti vengono archiviati come parti del pacchetto e vengono identificati dal relativo URI. Le parti del pacchetto possono essere esaminate usando GetParts(). Per altre informazioni sull'aggiornamento delle parti del pacchetto, vedere l'API Package .