DacServices.Extract 方法 (String, String, String, Version, String, IEnumerable<Tuple<String, String>>, DacExtractOptions, Nullable<CancellationToken>)

Extracts the schema from a database into a package.

命名空間：  Microsoft.SqlServer.Dac
組件：  Microsoft.SqlServer.Dac (在 Microsoft.SqlServer.Dac.dll 中)

語法

'宣告
Public Sub Extract ( _
    packageFileName As String, _
    databaseName As String, _
    applicationName As String, _
    applicationVersion As Version, _
    applicationDescription As String, _
    tables As IEnumerable(Of Tuple(Of String, String)), _
    extractOptions As DacExtractOptions, _
    cancellationToken As Nullable(Of CancellationToken) _
)
'用途
Dim instance As DacServices 
Dim packageFileName As String 
Dim databaseName As String 
Dim applicationName As String 
Dim applicationVersion As Version 
Dim applicationDescription As String 
Dim tables As IEnumerable(Of Tuple(Of String, String))
Dim extractOptions As DacExtractOptions 
Dim cancellationToken As Nullable(Of CancellationToken)

instance.Extract(packageFileName, databaseName, _
    applicationName, applicationVersion, _
    applicationDescription, tables, _
    extractOptions, cancellationToken)

public void Extract(
    string packageFileName,
    string databaseName,
    string applicationName,
    Version applicationVersion,
    string applicationDescription,
    IEnumerable<Tuple<string, string>> tables,
    DacExtractOptions extractOptions,
    Nullable<CancellationToken> cancellationToken
)

public:
void Extract(
    String^ packageFileName, 
    String^ databaseName, 
    String^ applicationName, 
    Version^ applicationVersion, 
    String^ applicationDescription, 
    IEnumerable<Tuple<String^, String^>^>^ tables, 
    DacExtractOptions^ extractOptions, 
    Nullable<CancellationToken> cancellationToken
)

member Extract : 
        packageFileName:string * 
        databaseName:string * 
        applicationName:string * 
        applicationVersion:Version * 
        applicationDescription:string * 
        tables:IEnumerable<Tuple<string, string>> * 
        extractOptions:DacExtractOptions * 
        cancellationToken:Nullable<CancellationToken> -> unit

public function Extract(
    packageFileName : String, 
    databaseName : String, 
    applicationName : String, 
    applicationVersion : Version, 
    applicationDescription : String, 
    tables : IEnumerable<Tuple<String, String>>, 
    extractOptions : DacExtractOptions, 
    cancellationToken : Nullable<CancellationToken>
)

參數

• packageFileName
  型別：System.String
  Path to the package file to be created.

• databaseName
  型別：System.String
  Name of the source database.

• applicationName
  型別：System.String
  String identifier for the DAC application.

• applicationVersion
  型別：System.Version
  Version of the DAC application.

• applicationDescription
  型別：System.String
  Optional string summary of the DAC application.

• tables
  型別：System.Collections.Generic.IEnumerable<Tuple<String, String>>
  Optional enumerable used to retrieve enumerator over set of tables for which reference data should be stored. For each Tuple in the enumeration the first item specifies the schema of the table, and the second specifies the base identifier of the table. If the value for this parameter is a null reference, no reference data will be stored.

• extractOptions
  型別：Microsoft.SqlServer.Dac.DacExtractOptions
  Optional DacExtractOptions instance used to specify options that affect the behavior of package extraction.

• cancellationToken
  型別：System.Nullable<CancellationToken>
  Optional CancellationToken that can be used to indicate that the operation should be cancelled. Use of this object does not guarantee that the operation will be cancelled.

例外狀況

例外狀況	條件
ArgumentException	If applicationName is a null reference or empty string.
DacServicesException	If a problem occurs during package extraction.
OperationCanceledException	If the CancellationToken has a cancellation requested and the operation could be cancelled.

請參閱

參考

DacServices 類別

Extract 多載

Microsoft.SqlServer.Dac 命名空間