This documentation is archived and is not being maintained.

RdaTrackOption Enumeration

Note: This namespace, class, or member is supported only in version 1.1 of the .NET Framework.

Specifies whether or not the table being pulled to the device is tracked.

[Visual Basic]
<Serializable>
Public Enum RdaTrackOption
[C#]
[Serializable]
public enum RdaTrackOption
[C++]
[Serializable]
__value public enum RdaTrackOption
[JScript]
public
   Serializable
enum RdaTrackOption

Remarks

RdaTrackOption specifies whether SQL Server CE will track changes to the pulled table. Specify TrackingOn or TrackingOnWithIndexes if you want to update the pulled table on the Windows CE .NET-based device and then push changed records back to the original SQL Server table. When TrackingOn is specified, PRIMARY KEY constraints are created on the pulled table. When TrackingOnWithIndexes is specified, PRIMARY KEY constraints and related indexes are created on the pulled table. (An index will be created only if the column or columns that make up the index is pulled.) In both cases, SQL Server CE keeps track of every record that is inserted, updated, or deleted in the local table.

When the application calls the Push method, SQL Server CE uses the change tracking information to locate the inserted, updated, and deleted records in the local SQL Server CE table and propagate these changes back to SQL Server.

The following restrictions apply when RdaTrackOption is set to TrackingOn or TrackingOnWithIndexes:

  • An error occurs if the SELECT statement returns a nonupdatable recordset.
  • A primary key must be defined on the updatable recordset returned by the SELECT statement.
  • The SELECT statement can reference a view or stored procedure, but the view or stored procedure must reference only one table and must be updatable.
  • When TrackingOnWithIndexes is specified, indexes that exist on the SQL Server table and are relevant to the columns specified in sqlSelectString are created against the SQL Server CE local table specified in localTableName.

errorTableName specifies the name of the table in which Push errors should be stored. If an error arises when the application calls the Push method, SQL Server CE creates the error table and inserts a record in the table for each error that occurs. When the Push method completes, the application can examine the error table to determine whether errors have occurred. errorTableName can be specified only when TrackingOn or TrackingOnWithIndexes is specified. For more information about how the error table works in RDA, see "RDA Conflict Detection and Resolution" in the SQL Server CE Books Online.

Members

Member name Description
TrackingOff

Supported only by the .NET Compact Framework.

Indicates that SQL Server CE does not track changes to the pulled table. No PRIMARY KEY constraints are created locally.
TrackingOffWithIndexes

Supported only by the .NET Compact Framework.

Indicates that SQL Server CE does not track changes to the pulled table. Indexes and PRIMARY KEY constraints that existed on the SQL Server table specified in sqlSelectString are created on the local table.
TrackingOn

Supported only by the .NET Compact Framework.

Indicates that SQL Server CE tracks all changes to the pulled table. PRIMARY KEY constraints related to the value specified for sqlSelectString are created on the local table. (default)
TrackingOnWithIndexes

Supported only by the .NET Compact Framework.

Indicates that SQL Server CE tracks all changes to the pulled table. Indexes and PRIMARY KEY constraints that existed on the SQL Server table specified in sqlSelectString are created on the local table.

Requirements

Namespace: System.Data.SqlServerCe

Platforms: .NET Compact Framework

Assembly: System.Data.Sqlserverce (in System.Data.Sqlserverce.dll)

See Also

System.Data.SqlServerCe Namespace

Show: