(PWS4 IIS4 IIS5)
Refresh — コレクションのオブジェクトを更新し、プロバイダから使用可能な、プロバイダに固有のオブジェクトを反映します。
collection.Refresh
| collection | Parameters コレクションを指定します。 |
|---|
オブジェクトへの参照を返します。
Refresh メソッドは、どのコレクションから呼び出すかによって異なるタスクを実行します。
オブジェクトの中には、Properties コレクションで Refresh メソッドを使用すると、プロバイダが公開するダイナミックプロパティによって Properties コレクションを更新するものがあります。これらのプロパティは、ADO でサポートされている組み込みプロパティにはない、プロバイダに固有の機能に関する情報を提供します。
(PWS4 IIS4 IIS5)
Item — コレクションの特定のメンバをその名前またはインデックスで示します。
Set object = collection.Item( Index )
| Index | コレクション内のオブジェクト名またはインデックスと評価されるバリアント型 (Variant) の値を指定します。 |
|---|
オブジェクトへの参照を返します。
コレクション内の特定のオブジェクトを返すには、Item プロパティを使います。コレクション内で Item が Index 引数に対応するオブジェクトを見つけられない場合、エラーが発生します。また、コレクションの中には名前付きオブジェクトをサポートしていないものもあります。このようなコレクションでは、その序数参照を使う必要があります。
Item プロパティはすべてのコレクションの既定プロパティなので、次のいずれの構文形式でも同じ結果が得られます。
1 2 | collection.Item (Index) collection (Index) |
(PWS4 IIS4 IIS5)
Delete — Parameters コレクションからオブジェクトを削除します。
Parameters.Delete Index
| Index | 削除するオブジェクトの名前、またはコレクション内の位置 (インデックス) を含む文字列型 (String) の値を指定します。 |
|---|
コレクションで Delete メソッドを使用すると、コレクションからオブジェクトの 1 つを削除することができます。このメソッドは、Command オブジェクトの Parameters コレクションでのみ使用できます。Delete メソッドを呼び出す際には Parameter オブジェクトの Name プロパティか、コレクションインデックスを使う必要があります。これは、オブジェクト変数が有効な引数ではないためです。
(PWS4 IIS4 IIS5)
Append — コレクションにオブジェクトを追加します。コレクションが Fields である場合、コレクションにオブジェクトが追加される前に、新規 Field オブジェクトが作成されることがあります。
fields.Append Name, Type, DefinedSize, Attrib, FieldValue
| fields | Fields コレクションを指定します。 |
|---|---|
| object | 追加するオブジェクトを表すオブジェクト変数を指定します。 |
| Name | 新規 Field オブジェクトの名前を含む文字列型 (String) の値を指定します。fields に含まれるほかのオブジェクトとは異なる名前にする必要があります。 |
| Type | 新規フィールドのデータ型を DataTypeEnum 値で指定します。既定値は adEmpty です。adIDispatch、adIUnknown、および adVariant の各データ型は、ADO ではサポートされていません。したがって、Recordset に新規フィールドを追加するときに、これらのデータ型を使用することはできません。 |
| DefinedSize | 省略可能です。新規フィールドの指定サイズを文字数またはバイト数で表す長整数型 (Long) の値を指定します。このパラメータの既定値は、Type によって決まります。DefinedSize が 255 バイトを超えるフィールドは、可変長列として扱われます (既定の DefinedSize は指定されません)。 |
| Attrib | 省略可能です。新規フィールドの属性を FieldAttributeEnum 値で指定します。既定値は adFldDefault です。値を指定しない場合は、Type に基づいた属性が設定されます。 |
| FieldValue | 省略可能です。新規フィールドの値を表すバリアント型 (Variant) の値を指定します。値を指定しない場合は、Null 値が設定されます。 |
Parameters コレクションにオブジェクトを追加する前に、Parameter オブジェクトの Type プロパティを設定する必要があります。可変長データ型を選択した場合は、Size プロパティを 0 より大きい値に設定することも必要です。
パラメータを指定することにより、ストアド プロシージャまたはパラメータクエリの使用時に、プロバイダの呼び出しを最小限に抑えてパフォーマンスを向上させることができます。そのためには、呼び出すストアドプロシージャまたはパラメータ クエリに関するパラメータのプロパティを把握している必要があります。
CreateParameter メソッドを使って適切なプロパティ設定を持つ Parameter オブジェクトを作成し、Append メソッドを使ってそれらを Parameters コレクションに追加します。こうすれば、プロバイダを呼び出してパラメータ情報を取り出さなくても、パラメータ値を設定して返すことができます。パラメータ情報を提供しないプロバイダに書き込む場合にパラメータを使用するには、CreateParameter メソッドを使って手動で Parameters コレクションを作成する必要があります。
開いている Record の Fields コレクションで Append メソッドを呼び出しても、実行時エラーは発生しません。新規フィールドは、Record オブジェクトの Fields コレクションに追加されます。ただし、Recordset からの Record の場合、Recordset オブジェクトの Fields コレクションに新規フィールドは追加されません。
存在しないフィールドを作成して Fields コレクションに追加することができます。このためには、コレクションに既に存在しているフィールドの場合と同じように、フィールドオブジェクトに値を指定します。この指定によって、その Field オブジェクトの作成と追加が自動的に実行されます。
Record オブジェクトの Fields コレクションに Field を追加した後は、Fields コレクションの Update メソッドを呼び出して変更を保存してください。
(PWS4 IIS4 IIS5)
Count — コレクション内のオブジェクト数を示します。
object.Count
| object | Parameters コレクションを指定します。 |
|---|
長整数型 (Long) の値を返します。
Count プロパティは、コレクション内のオブジェクトの数を調べるために使います。
コレクションのメンバは 0 から順に番号が割り当てられるため、ループを使う場合は常に 0 から始めて、Count プロパティより 1 小さい値で終わらせる必要があります。Microsoft Visual Basic を使っていて、ループ内で Count プロパティをチェックせずにコレクションのメンバを指定するには、For Each…Next コマンドを使います。
Count プロパティが 0 の場合、コレクションにはオブジェクトが含まれていないことを意味します。