DacServices.Extract 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
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)
參數
- 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 有人申請取消,手術可能會被取消。