DacServices.Extract Methode

Definition

Überlädt

Extract(Stream, String, String, Version, String, IEnumerable<Tuple<String,String>>, DacExtractOptions, Nullable<CancellationToken>)

Extrahieren Sie das Schema aus einer Datenbank in ein Paket.

public void Extract(System.IO.Stream packageStream, string databaseName, string applicationName, Version applicationVersion, string applicationDescription = default, System.Collections.Generic.IEnumerable<Tuple<string,string>> tables = default, Microsoft.SqlServer.Dac.DacExtractOptions extractOptions = default, System.Threading.CancellationToken? cancellationToken = default);
member this.Extract : System.IO.Stream * string * string * Version * string * seq<string * string> * Microsoft.SqlServer.Dac.DacExtractOptions * Nullable<System.Threading.CancellationToken> -> unit
Public Sub Extract (packageStream As Stream, databaseName As String, applicationName As String, applicationVersion As Version, Optional applicationDescription As String = Nothing, Optional tables As IEnumerable(Of Tuple(Of String, String)) = Nothing, Optional extractOptions As DacExtractOptions = Nothing, Optional cancellationToken As Nullable(Of CancellationToken) = Nothing)

Parameter

packageStream
Stream

Stream in die das Paket geschrieben werden soll.

databaseName
String

Name der Quelldatenbank.

applicationName
String

Zeichenfolgenbezeichner für die DAC-Anwendung.

applicationVersion
Version

Version der DAC-Anwendung.

applicationDescription
String

Optionale Zeichenfolgenzusammenfassung der DAC-Anwendung.

tables
IEnumerable<Tuple<String,String>>

Optionaler Aufzählungswert, der zum Abrufen des Enumerators über einen Satz von Tabellen verwendet werden kann, für die Daten exportiert werden sollen. Für jede Tuple in der Enumeration gibt das erste Element das Schema der Tabelle an, und die zweite gibt den Basisbezeichner der Tabelle an.

Wenn der Wert für diesen Parameter ein Nullverweis ist, werden keine Daten exportiert.

extractOptions
DacExtractOptions

Optionale DacExtractOptions Instanz, die verwendet wird, um Optionen anzugeben, die sich auf das Verhalten der Paketextraktion auswirken.

cancellationToken
Nullable<CancellationToken>

Optional CancellationToken , das verwendet werden kann, um anzugeben, dass der Vorgang abgebrochen werden soll. Die Verwendung dieses Objekts garantiert nicht, dass der Vorgang abgebrochen wird.

Ausnahmen

Wenn applicationName es sich um einen Nullverweis oder eine leere Zeichenfolge handelt.

Wenn während der Paketextraktion ein Problem auftritt; oder der bereitgestellte Datenstrom eignet sich nicht zum Schreiben des Pakets.

Wenn ein CancellationToken Abbruch angefordert wurde und der Vorgang abgebrochen werden kann.

Gilt für:

Extract(String, String, String, Version, String, IEnumerable<Tuple<String,String>>, DacExtractOptions, Nullable<CancellationToken>)

Extrahieren Sie das Schema aus einer Datenbank in ein Paket.

public void Extract(string packageFileName, string databaseName, string applicationName, Version applicationVersion, string applicationDescription = default, System.Collections.Generic.IEnumerable<Tuple<string,string>> tables = default, Microsoft.SqlServer.Dac.DacExtractOptions extractOptions = default, System.Threading.CancellationToken? cancellationToken = default);
public void Extract(string targetPath, string databaseName, string applicationName, Version applicationVersion, string applicationDescription = default, System.Collections.Generic.IEnumerable<Tuple<string,string>> tables = default, Microsoft.SqlServer.Dac.DacExtractOptions extractOptions = default, System.Threading.CancellationToken? cancellationToken = default);
member this.Extract : string * string * string * Version * string * seq<string * string> * Microsoft.SqlServer.Dac.DacExtractOptions * Nullable<System.Threading.CancellationToken> -> unit
member this.Extract : string * string * string * Version * string * seq<string * string> * Microsoft.SqlServer.Dac.DacExtractOptions * Nullable<System.Threading.CancellationToken> -> unit
Public Sub Extract (packageFileName As String, databaseName As String, applicationName As String, applicationVersion As Version, Optional applicationDescription As String = Nothing, Optional tables As IEnumerable(Of Tuple(Of String, String)) = Nothing, Optional extractOptions As DacExtractOptions = Nothing, Optional cancellationToken As Nullable(Of CancellationToken) = Nothing)
Public Sub Extract (targetPath As String, databaseName As String, applicationName As String, applicationVersion As Version, Optional applicationDescription As String = Nothing, Optional tables As IEnumerable(Of Tuple(Of String, String)) = Nothing, Optional extractOptions As DacExtractOptions = Nothing, Optional cancellationToken As Nullable(Of CancellationToken) = Nothing)

Parameter

packageFileNametargetPath
String

Pfad zur zu erstellenden Paketdatei.

databaseName
String

Name der Quelldatenbank.

applicationName
String

Zeichenfolgenbezeichner für die DAC-Anwendung.

applicationVersion
Version

Version der DAC-Anwendung.

applicationDescription
String

Optionale Zeichenfolgenzusammenfassung der DAC-Anwendung.

tables
IEnumerable<Tuple<String,String>>

Optionaler Aufzählungswert, der zum Abrufen des Enumerationers über einen Satz von Tabellen verwendet werden kann, für die Referenzdaten gespeichert werden sollen. Für jede Tuple in der Enumeration gibt das erste Element das Schema der Tabelle an, und die zweite gibt den Basisbezeichner der Tabelle an.

Wenn der Wert für diesen Parameter ein Nullverweis ist, werden keine Referenzdaten gespeichert.

extractOptions
DacExtractOptions

Optionale DacExtractOptions Instanz, die verwendet wird, um Optionen anzugeben, die sich auf das Verhalten der Paketextraktion auswirken.

cancellationToken
Nullable<CancellationToken>

Optional CancellationToken , das verwendet werden kann, um anzugeben, dass der Vorgang abgebrochen werden soll. Die Verwendung dieses Objekts garantiert nicht, dass der Vorgang abgebrochen wird.

Ausnahmen

Wenn applicationName es sich um einen Nullverweis oder eine leere Zeichenfolge handelt.

Wenn während der Paketextraktion ein Problem auftritt.

Wenn ein CancellationToken Abbruch angefordert wurde und der Vorgang abgebrochen werden kann.

Gilt für: