DacServices.ExportBacpac Method (Stream, String, DacExportOptions, IEnumerable<Tuple<String, String>>, Nullable<CancellationToken>)

Extract schema and export data from a database into a "bacpac" package.

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

Syntax

'Declaration
Public Sub ExportBacpac ( _
    packageStream As Stream, _
    databaseName As String, _
    options As DacExportOptions, _
    tables As IEnumerable(Of Tuple(Of String, String)), _
    cancellationToken As Nullable(Of CancellationToken) _
)
'Usage
Dim instance As DacServices 
Dim packageStream As Stream 
Dim databaseName As String 
Dim options As DacExportOptions 
Dim tables As IEnumerable(Of Tuple(Of String, String))
Dim cancellationToken As Nullable(Of CancellationToken)

instance.ExportBacpac(packageStream, _
    databaseName, options, tables, cancellationToken)
public void ExportBacpac(
    Stream packageStream,
    string databaseName,
    DacExportOptions options,
    IEnumerable<Tuple<string, string>> tables,
    Nullable<CancellationToken> cancellationToken
)
public:
void ExportBacpac(
    Stream^ packageStream, 
    String^ databaseName, 
    DacExportOptions^ options, 
    IEnumerable<Tuple<String^, String^>^>^ tables, 
    Nullable<CancellationToken> cancellationToken
)
member ExportBacpac : 
        packageStream:Stream * 
        databaseName:string * 
        options:DacExportOptions * 
        tables:IEnumerable<Tuple<string, string>> * 
        cancellationToken:Nullable<CancellationToken> -> unit
public function ExportBacpac(
    packageStream : Stream, 
    databaseName : String, 
    options : DacExportOptions, 
    tables : IEnumerable<Tuple<String, String>>, 
    cancellationToken : Nullable<CancellationToken>
)

Parameters

  • packageStream
    Type: Stream
    Stream to which to write the package.
  • databaseName
    Type: String
    Name of the source database.
  • tables
    Type: IEnumerable<Tuple<String, String>>
    Optional enumerable used to retrieve enumerator over set of tables for which data should be exported. 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.
  • cancellationToken
    Type: 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.

Exceptions

Exception Condition
ArgumentException

If the value for any of the required parameters is a null reference or an empty string.

DacServicesException

If an error occurs during schema deployment and data export; or if options specifies a table that does not exist in the schema contained in the supplied package.

OperationCanceledException

If the CancellationToken has a cancellation requested and the operation could be cancelled.

See Also

Reference

DacServices Class

ExportBacpac Overload

Microsoft.SqlServer.Dac Namespace