DacPackageExtensions-Klasse

Artikel
07/22/2015

Stellt Methoden bereit, die das Bearbeiten von DacPackage-Objekten unterstützen. Diese Methoden funktionieren für ein vorhandenes DacPackage.

Vererbungshierarchie

System.Object
Microsoft.SqlServer.Dac.DacPackageExtensions

Namespace: Microsoft.SqlServer.Dac
Assembly: Microsoft.SqlServer.Dac.Extensions (in Microsoft.SqlServer.Dac.Extensions.dll)

Syntax

'Declaration
<ExtensionAttribute> _
Public NotInheritable Class DacPackageExtensions
'Usage

public static class DacPackageExtensions

[ExtensionAttribute]
public ref class DacPackageExtensions abstract sealed

[<AbstractClassAttribute>]
[<SealedAttribute>]
type DacPackageExtensions =  class end

public final class DacPackageExtensions

Der DacPackageExtensions-Typ macht folgende Elemente verfügbar.

Methoden

	Name	Beschreibung
	BuildPackage(Stream, TSqlModel, PackageMetadata)	Erstellt ein Paket mit dem angegebenen TSqlModel und speichert es im angegebenen Stream.
	BuildPackage(String, TSqlModel, PackageMetadata)	Erstellt ein Paket mit dem angegebenen TSqlModel und speichert es am angegebenen Speicherort.
	BuildPackage(Stream, TSqlModel, PackageMetadata, PackageOptions)	Erstellt ein Paket mit dem angegebenen TSqlModel und speichert es im angegebenen Stream.Zusätzlich zum TSqlModel können andere Artefakte wie Umgestaltungsprotokoll und Bereitstellungs-Contributors in packageOptions angegeben werden.
	BuildPackage(String, TSqlModel, PackageMetadata, PackageOptions)	Erstellt ein Paket mit dem angegebenen TSqlModel und speichert es am angegebenen Speicherort.Zusätzlich zum TSqlModel können andere Artefakte wie Umgestaltungsprotokoll und Bereitstellungs-Contributors in packageOptions angegeben werden.
	UpdateModel	Aktualisiert das Modell in einem DacPackage, wobei das aktuelle Modell durch ein neues Modell ersetzt wird.Vor dem Aktualisieren wird das Modell validiert; wenn Fehler festgestellt werden, wird eine DacServicesException ausgelöst.Wenn Aufrufer Warnungen und Fehler blockieren möchten, müssen sie das Modell durch Aufrufen von Validate() validieren und überprüfen, ob in den zurückgegebenen Meldungen Fehler oder Warnungen enthalten sind.Hinweis: Nur das Modell wird ersetzt – alle übrigen Artefakte wie Umgestaltungsprotokoll, Skript vor der Bereitstellung, Skript nach der Bereitstellung und Contributor-Artefakte werden nicht geändert.Wenn sich Artefakte auf Elemente stützen, die im aktualisierten Modell nicht mehr enthalten sind, kann die Bereitstellung fehlschlagen.Der Aufrufer muss sicherstellen, dass die betreffenden Artefakte mit dem neuen Modell konsistent sind.Mit der Package-API können andere Artefakte wie das Umgestaltungsprotokoll und Skripts aktualisiert werden, um ihre Konsistenz mit dem aktuellen Modell sicherzustellen.Diese Artefakte werden als Paketteile gespeichert und anhand ihres URI identifiziert.Paketteile können mithilfe von GetParts() untersucht werden.Weitere Informationen zum Aktualisieren von Paketteilen finden Sie in der Package-API.

Zum Anfang

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Microsoft.SqlServer.Dac-Namespace

Freigeben über