DacServices.Extract 方法

定義

多載

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

從資料庫中擷取結構到套件中。

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)

參數

packageStream
Stream

Stream 寫套件的來源。

databaseName
String

源資料庫的名稱。

applicationName
String

DAC 應用程式的字串識別碼。

applicationVersion
Version

DAC 應用程式的版本。

applicationDescription
String

DAC 應用程式的可選字串摘要。

tables
IEnumerable<Tuple<String,String>>

可選的可枚舉工具用於檢索應匯出資料表的列舉器。 對於列舉中的每個 Tuple 項目,第一個項目指定該表的結構,第二個項目則指定該表的基底識別碼。

若此參數值為空參考,則不會匯出資料。

extractOptions
DacExtractOptions

可選 DacExtractOptions 實例用來指定影響套件擷取行為的選項。

cancellationToken
Nullable<CancellationToken>

可選 CancellationToken 性,可用來表示該操作應該被取消。 使用此物件並不保證該操作會被取消。

例外狀況

如果 applicationName 是空參考或空字串。

若在擷取過程中發生問題;或是所提供的串流不適合撰寫該套件。

如果 CancellationToken 有人申請取消,手術可能會被取消。

適用於

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

從資料庫中擷取結構到套件中。

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)

參數

packageFileNametargetPath
String

要建立套件檔案的路徑。

databaseName
String

源資料庫的名稱。

applicationName
String

DAC 應用程式的字串識別碼。

applicationVersion
Version

DAC 應用程式的版本。

applicationDescription
String

DAC 應用程式的可選字串摘要。

tables
IEnumerable<Tuple<String,String>>

可選的可枚舉工具用於檢索應儲存參考資料的表格列舉器。 對於列舉中的每個 Tuple 項目,第一個項目指定該表的結構,第二個項目則指定該表的基底識別碼。

若此參數值為空參考,則不會儲存參考資料。

extractOptions
DacExtractOptions

可選 DacExtractOptions 實例用來指定影響套件擷取行為的選項。

cancellationToken
Nullable<CancellationToken>

可選 CancellationToken 性,可用來表示該操作應該被取消。 使用此物件並不保證該操作會被取消。

例外狀況

如果 applicationName 是空參考或空字串。

如果在擷取套件時發生問題。

如果 CancellationToken 有人申請取消,手術可能會被取消。

適用於