Datasnap.Provider.TProviderOption

提供:RAD Studio API Documentation

Delphi

TProviderOption = (poFetchBlobsOnDemand, poFetchDetailsOnDemand,
poIncFieldProps, poCascadeDeletes, poCascadeUpdates, poReadOnly,
poAllowMultiRecordUpdates, poDisableInserts, poDisableEdits,
poDisableDeletes, poNoReset, poAutoRefresh, poPropogateChanges,
poAllowCommandText, poRetainServerOrder, poUseQuoteChar );

C++

enum DECLSPEC_DENUM TProviderOption : unsigned char { poFetchBlobsOnDemand, poFetchDetailsOnDemand, poIncFieldProps, poCascadeDeletes, poCascadeUpdates, poReadOnly, poAllowMultiRecordUpdates, poDisableInserts, poDisableEdits, poDisableDeletes, poNoReset, poAutoRefresh, poPropogateChanges, poAllowCommandText, poRetainServerOrder, poUseQuoteChar };

プロパティ

種類 可視性 ソース ユニット 親
enum public
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider Datasnap.Provider

説明

TProviderOption 型および TProviderOptions 型は、クライアント データセットとプロバイダ コンポーネントとの間でやり取りされる情報の種類を指定します。

TProviderOptions は TProviderOption 値の集合です。TProviderOption には以下の値を指定できます。



値 意味

poFetchBlobsOnDemand

BLOB フィールドはデータ パケットには含まれません。その代わりに、クライアント アプリケーションは、必要に応じてこれらの値を要求しなければなりません。クライアント データセットの FetchOnDemand プロパティが true の場合、クライアントはこれらの値を自動的に要求します。それ以外の場合、クライアント アプリケーションは FetchBlobs メソッドを使用して BLOB データを取得します。

poFetchDetailsOnDemand

プロバイダがマスター/詳細(master/detail)関係のマスターを表している場合、ネストしている詳細値はデータ パケットには含まれません。その代わりに、クライアント アプリケーションは、必要に応じてこれらの値を要求しなければなりません。クライアント データセットの FetchOnDemand プロパティが true の場合、クライアントはこれらの値を自動的に要求します。それ以外の場合、クライアント アプリケーションは FetchDetails メソッドを使用して、ネストしている詳細データセットを取得します。

poIncFieldProps

データパケットには、(必要に応じて)次のフィールド プロパティが含まれます。Alignment、 DisplayLabel、 DisplayWidth、 Visible、 DisplayFormat、 EditFormat、 MaxValue、 MinValue、 Currency、 EditMask および DisplayValues。

poCascadeDeletes

マスター テーブルのレコードが削除された場合に、詳細レコードを自動的に削除するようにサーバーに指示します。このオプションを使用するには、プロバイダがマスター/詳細関係のマスターを表し、データベースが、参照整合性の設定の一部としてカスケード削除をサポートしている必要があります。

poCascadeUpdates

マスター テーブルのキー値が変更された場合に、詳細レコードを自動的に更新するようにサーバーに指示します。このオプションを使用するには、プロバイダがマスター/詳細関係のマスターを表し、データベースが、参照整合性の設定の一部としてカスケード更新をサポートしている必要があります。

poReadOnly

クライアント データセットは更新をプロバイダに適用できません。

poAllowMultiRecordUpdates

個々の変更が複数のレコードに影響するのを許可します。poAllowMultiRecordUpdates が含まれていない場合、複数のレコードを変更する更新は自動的に中止されます。

poDisableInserts

クライアントは新しいレコードを追加できません。クライアントがレコードを挿入しようとすると、例外が発生します。クライアントがレコードを編集または削除する機能には影響しません。

poDisableEdits

クライアントは既存のデータ値を変更できません。クライアントがフィールドを編集しようとすると、例外が発生します。クライアントがレコードを挿入または削除する機能には影響しません。

poDisableDeletes

クライアントはレコードを削除できません。クライアントがレコードを削除しようとすると、例外が発生します。クライアントがレコードを編集または挿入する機能には影響しません。

poNoReset

AS_GetRecords への呼び出しのリセット フラグ(grReset の TGetRecordsOption 値)を無視します。

poAutoRefresh

更新を適用するたびに現在のレコードの値を使ってクライアント データセットを更新します。

poPropogateChanges

BeforeUpdateRecord または AfterUpdateRecord イベント ハンドラでの変更は、クライアントに送り返し、クライアント データセットにマージします。

poAllowCommandText

プロバイダに関連付けられている SQL テキスト、あるいはストアド プロシージャやテーブルの名前を置換することによって、クライアントがプロバイダのデータセットをオーバーライドできるようにします。これらのオーバーライドは、GetRecords メソッドまたは Execute メソッドで可能です。

poRetainServerOrder

クライアントがデータ パケット内のレコードをソートしてデフォルトの順序を変更してはならないことを通知します。これにより、サーバー上のロケールを複製できないなどの理由で、クライアントがレコードの順序を変更するのを防止できます。

poUseQuoteChar

SQL プロバイダによって使われる引用符(")が、プロバイダによって作成された SQL クエリ内の SQL 識別子を囲むためにも使用されるように指定します。このオプションはデフォルトで true です。引用符を無視するには、このオプションを false に設定します。



関連項目