Share via

TransferSqlServerObjectsTask.UseCollation Property

  • Article

Gets or sets a Boolean indicating whether the transfer should use collations.

Namespace:  Microsoft.SqlServer.Dts.Tasks.TransferSqlServerObjectsTask
Assembly:  Microsoft.SqlServer.TransferSqlServerObjectsTask (in Microsoft.SqlServer.TransferSqlServerObjectsTask.dll)

Syntax

'Declaration
Public Property UseCollation As Boolean 
    Get 
    Set
'Usage
Dim instance As TransferSqlServerObjectsTask 
Dim value As Boolean 

value = instance.UseCollation

instance.UseCollation = value

public bool UseCollation { get; set; }

public:
virtual property bool UseCollation {
    bool get () sealed;
    void set (bool value) sealed;
}

abstract UseCollation : bool with get, set 
override UseCollation : bool with get, set

final function get UseCollation () : boolean 
final function set UseCollation (value : boolean)

Property Value

Type: System.Boolean
true if the transfer includes the collation; false if the collation at the destination is used.

Implements

ITransferSqlServerObjectsTask.UseCollation

Remarks

If UseCollation is set to true, column-level collation settings are maintained when transferring data between computers running an instance of SQL Server 2000 or later if the code pages are the same on both servers. When data is transferred to a computer running an instance of SQL Server 2000, and the destination instance uses a different code page than the source, all collation settings at the source server are automatically translated to the code page of the destination server.

When data is transferred to a computer running an instance of SQL Server version 7.0 or earlier, all collation settings at the source server are automatically translated to the code page of the destination server if the code pages settings are different. The source database column-level collation is translated accordingly.

If UseCollation is set to false, direct data transfer is performed if the code pages are the same on both servers. If the code pages are different, the data is translated from the code page of the source to the code page of the destination. If both computers are running SQL Server 2000 and the source and destination databases are using different code pages, data might be translated to the incorrect code page setting, depending on whether the column is using the default or a nondefault collation.

Note

Setting UseCollation to true can result in a decrease in performance if the data contains non-Unicode data types such as text or varchar. Performance can also be affected by the number of tables, columns, and rows in the source database.

See Also

Reference

TransferSqlServerObjectsTask Class

Microsoft.SqlServer.Dts.Tasks.TransferSqlServerObjectsTask Namespace