DacPackage Classe

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Dac

Assembly:: Microsoft.SqlServer.Dac.dll

Pacchetto:: Microsoft.SqlServer.DacFx.x64 v140.3881.1

Pacchetto:: Microsoft.SqlServer.DacFx v150.5282.3

Pacchetto:: Microsoft.SqlServer.DacFx v160.6161.0

Pacchetto:: Microsoft.SqlServer.DacFx v162.2.111

Pacchetto:: Microsoft.Data.Tools.Msbuild v10.0.61804.210

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresentazione dell'artefatto che contiene la definizione di un'applicazione livello dati.

public sealed class DacPackage : IDisposable

type DacPackage = class
    interface IDisposable

Public NotInheritable Class DacPackage
Implements IDisposable

Ereditarietà: Object
DacPackage

Implementazioni: IDisposable

Proprietà

Nome	Descrizione
Description	Ottenere un riepilogo facoltativo di questo pacchetto.
Name	Ottenere l'identificatore per questo pacchetto.
PostDeploymentScript	Ottenere il flusso usato per leggere e scrivere script eseguiti dopo la distribuzione dello schema contenuto in questo pacchetto.
PreDeploymentScript	Ottenere il flusso usato per leggere e scrivere script eseguiti prima della distribuzione dello schema contenuto in questo pacchetto.
Version	Ottenere informazioni sulla versione per questo pacchetto.
VersionPrefix	Ottenere informazioni sul prefisso della versione per la versione del pacchetto, ad esempio VersionPrefix, sarà "preview" per la versione di anteprima e "" per la versione rilasciata

Metodi

Nome	Descrizione
Dispose()	Rilasciare le risorse contenute in questa istanza.
Load(Stream, DacSchemaModelStorageType, FileAccess)	Caricare un pacchetto dall'oggetto specificato Stream.
Load(Stream, DacSchemaModelStorageType)	Caricare un pacchetto dall'oggetto specificato Stream.
Load(Stream)	Caricare un pacchetto dall'oggetto specificato Stream.
Load(String, DacSchemaModelStorageType, FileAccess)	Caricare un file di pacchetto specificato da `fileName`.
Load(String, DacSchemaModelStorageType)	Caricare un file di pacchetto specificato da `fileName`.
Load(String)	Caricare un file di pacchetto specificato da `fileName`.
Unpack(String)	Inserire il contenuto del pacchetto nella directory specificata da `directoryPath`.

Metodi di estensione

Nome	Descrizione
GetCollationString(DacPackage)	Restituisce le regole di confronto del database per il pacchetto.
IsLedgerOn(DacPackage)	Rappresentazione dell'artefatto che contiene la definizione di un'applicazione livello dati.
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 .

Nome

Descrizione

GetCollationString(DacPackage)

Restituisce le regole di confronto del database per il pacchetto.

IsLedgerOn(DacPackage)

Rappresentazione dell'artefatto che contiene la definizione di un'applicazione livello dati.

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 .

Si applica a