RdaTrackOption 列挙体

.NET Framework クラス ライブラリ リファレンス

RdaTrackOption 列挙体

デバイスにプルされたテーブルを追跡するかどうかを指定します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Enumeration RdaTrackOption

Visual Basic (使用法)

Dim instance As RdaTrackOption

C#

public enum RdaTrackOption

C++

public enum class RdaTrackOption

J#

public enum RdaTrackOption

JScript

public enum RdaTrackOption

メンバ

	メンバ名	説明
	TrackingOff	SQL Server Mobile で、プルされたテーブルへの変更を追跡しないことを示します。ローカルに PRIMARY KEY 制約は作成されません。
	TrackingOffWithIndexes	SQL Server Mobile で、プルされたテーブルへの変更を追跡しないことを示します。sqlSelectString で指定した SQL Server テーブルに存在するインデックスと PRIMARY KEY 制約が、ローカル テーブルに作成されます。
	TrackingOn	SQL Server Mobile で、プルされたテーブルへのすべての変更を追跡することを示します。sqlSelectString で指定した値に関連する PRIMARY KEY 制約が、ローカル テーブルに作成されます。これは、既定の設定です。
	TrackingOnWithIndexes	SQL Server Mobile で、プルされたテーブルへのすべての変更を追跡することを示します。sqlSelectString で指定した SQL Server テーブルに存在するインデックスと PRIMARY KEY 制約が、ローカル テーブルに作成されます。

解説

このプロパティでは、SQL Server Mobile によって、プルされたテーブルへの変更を追跡するかどうかを指定します。TrackingOn または TrackingOnWithIndexes を指定して、スマート デバイスにプルされたテーブルを更新し、その後、変更したレコードを元の SQL Server テーブルにプッシュできます。TrackingOn を指定した場合は、プルされたテーブルに PRIMARY KEY 制約が作成されます。TrackingOnWithIndexes を指定した場合は、プルされたテーブルに、PRIMARY KEY 制約および関連するインデックスが作成されます。

メモ
インデックスは、インデックスを構成する列がプルされた場合にだけ作成されます。

どちらの場合も、SQL Server Mobile は、ローカル テーブルで挿入、更新、または削除されたレコードをすべて追跡します。

アプリケーションが Push メソッドを呼び出すと、SQL Server Mobile は、ローカル SQL Server Mobile テーブルで挿入、更新、および削除されたレコードを変更追跡情報を使用して検索し、これらの変更を SQL Server に反映します。

RdaTrackOption が TrackingOn または TrackingOnWithIndexes に設定されている場合は、次の制限が適用されます。

• 更新できないレコードセットが SELECT ステートメントから返された場合は、エラーが発生します。

• 主キーは、SELECT ステートメントから返される更新可能なレコードセットに対して定義される必要があります。

• SELECT ステートメントでは、ビューまたはストアド プロシージャを参照できます。ただし、参照するビューまたはストアド プロシージャは、1 つのテーブルだけを参照していて、更新可能である必要があります。

• TrackingOnWithIndexes を指定した場合、SQL Server テーブルに存在し、Pull メソッドの sqlSelectString 引数で指定した列に関連するインデックスが、Pull の localTableName 引数で指定した SQL Server Mobile ローカル テーブルに対して作成されます。

errorTableName プロパティで、Push エラーを格納するテーブル名を指定します。SQL Server Mobile は、アプリケーションから Push メソッドが呼び出されたときにエラーが発生するとエラー テーブルを作成し、エラーが発生するたびにそのテーブルにレコードを挿入します。Push メソッドの完了時に、アプリケーションからエラー テーブルを確認して、エラーが発生したかどうかを調べることができます。errorTableName は、TrackingOn または TrackingOnWithIndexes が指定されている場合にだけ指定できます。RDA でのエラー テーブルの処理方法の詳細については、SQL Server Mobile Online の「リモート データ アクセス (RDA) の競合検出および競合解決」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
System.Data.SqlServerCe 名前空間
Pull