Reshape Name プロパティ - 動的 (ADO)
Recordset オブジェクトの名前を指定します。
戻り値
Recordset の名前である String 値を返します。
注釈
名前は、接続の期間中、または Recordset が閉じられるまで、保持されます。
Reshape Name プロパティは、主に、Microsoft Data Shaping Service for OLE DB サービス プロバイダーのリシェイプ機能で使うためのものです。 リシェイプに参加するには、名前が一意である必要があります。
このプロパティは読み取り専用ですが、Recordset が作成されるとき間接的に設定できます。 たとえば、Shape コマンドの句で Recordset を作成し、AS キーワードを使ってそれにエイリアス名を指定した場合、そのエイリアスが Reshape Name プロパティに割り当てられます。 エイリアスを宣言しないと、データ シェイプ サービスによって生成された一意の名前が Reshape Name プロパティに割り当てられます。 エイリアス名が既存の Recordset の名前と同じである場合は、それらのいずれかが解放されるまで、どちらの Recordset もリシェイプできません。 ADO 接続で Reshape Name プロパティの一意の名前を True に設定することで、既定の動作を変更できます。 このプロパティを設定すると、データ シェイプ サービスに、一意性を確保するために必要に応じてユーザー割り当て名を変更するアクセス許可が与えられます。 リシェイプについて詳しくは、Microsoft Data Shaping Service for OLE DB (ADO サービス プロバイダー) に関する記事をご覧ください。
Shape コマンドで Recordset を参照するとき、または Data Shaping Service によって生成されたために名前がわからないときは、Reshape Name プロパティを使います。 その場合、Reshape Name プロパティによって返された文字列の周囲にコマンドを連結することで、SHAPE コマンドを生成できます。
Reshape Name は、CursorLocation プロパティが adUseClient に設定されている場合に、Recordset オブジェクトの Properties コレクションに追加される動的プロパティです。
適用対象
参照
Microsoft Data Shaping Service for OLE DB (ADO サービス プロバイダー)
一般的な Shape コマンド
Recordset オブジェクト (ADO)