Condividi tramite


Classe DacPackageExtensions

Fornisce i metodi per supportare la gestione di oggetti DacPackage. Questi metodi funzionano in un oggetto DacPackage esistente.

Gerarchia di ereditarietà

System.Object
  Microsoft.SqlServer.Dac.DacPackageExtensions

Spazio dei nomi  Microsoft.SqlServer.Dac
Assembly:  Microsoft.SqlServer.Dac.Extensions (in Microsoft.SqlServer.Dac.Extensions.dll)

Sintassi

'Dichiarazione
<ExtensionAttribute> _
Public NotInheritable Class DacPackageExtensions
'Utilizzo
public static class DacPackageExtensions
[ExtensionAttribute]
public ref class DacPackageExtensions abstract sealed
[<AbstractClassAttribute>]
[<SealedAttribute>]
type DacPackageExtensions =  class end
public final class DacPackageExtensions

Nel tipo DacPackageExtensions sono esposti i membri seguenti.

Metodi

  Nome Descrizione
Metodo pubblicoMembro statico BuildPackage(Stream, TSqlModel, PackageMetadata) Crea un pacchetto con l'oggetto TSqlModel specificato e lo salva nell'oggetto Stream specificato.
Metodo pubblicoMembro statico BuildPackage(String, TSqlModel, PackageMetadata) Crea un pacchetto con l'oggetto TSqlModel specificato e lo salva nel percorso specificato.
Metodo pubblicoMembro statico BuildPackage(Stream, TSqlModel, PackageMetadata, PackageOptions) Crea un pacchetto con l'oggetto TSqlModel specificato e lo salva nell'oggetto Stream specificato.Oltre all'oggetto TSqlModel, altri elementi quali il log di refactoring e i collaboratori alla distribuzione possono essere specificati in packageOptions.
Metodo pubblicoMembro statico BuildPackage(String, TSqlModel, PackageMetadata, PackageOptions) Crea un pacchetto con l'oggetto TSqlModel specificato e lo salva nel percorso specificato.Oltre all'oggetto TSqlModel, altri elementi quali il log di refactoring e i collaboratori alla distribuzione possono essere specificati in packageOptions.
Metodo pubblicoMembro statico UpdateModel Aggiorna il modello in un oggetto DacPackage, sostituendo il modello corrente con uno nuovo.Prima di eseguire l'aggiornamento, il modello verrà convalidato e, in caso di errori, verrà generato un oggetto DacServicesException.Se i chiamanti desiderano bloccare avvisi ed errori, devono convalidare il modello chiamando il metodo Validate() e verificando se sono inclusi errori o avvisi nei messaggi restituiti.Nota: solo il modello viene sostituito; tutti gli altri elementi, ad esempio il log di refactoring, lo script di pre-distribuzione, lo script di post-distribuzione e gli elementi dei collaboratori non vengono modificati.Se uno di questi elementi si basa su altri non più disponibili nel modello aggiornato, la distribuzione potrebbe non riuscire.È responsabilità del chiamante garantire la coerenza di questi elementi con il nuovo modello.L'API dell'oggetto Package può essere utilizzata per aggiornare altri elementi quali il log di refactoring e gli script e mantenerli coerenti con il modello aggiornato.Questi elementi vengono archiviati come parti del pacchetto e vengono identificati dal relativo URI.Le parti del pacchetto possono essere esaminate con il metodo GetParts().Per ulteriori informazioni sull'aggiornamento delle parti del pacchetto, vedere l'API dell'oggetto Package.

In alto

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi Microsoft.SqlServer.Dac