適用先: Access 2013、Office 2013
新しいユーザー定義の Property オブジェクトを作成します (Microsoft Access ワークスペースのみ)。
構文
式 。CreateProperty(Name, Type, Value, DDL)
式Index オブジェクトを表す変数。
パラメーター
名前 |
必須かどうか |
データ型 |
説明 |
|---|---|---|---|
名前 |
省略可能 |
バリアント型 (Variant) |
新しい Property オブジェクトの一意の名前を表す文字列型 ( String ) の値。 有効な Property 名の詳細については、 Name プロパティを参照してください。 |
Type |
省略可能 |
バリアント型 (Variant) |
新しい Property オブジェクトのデータ型を定義する定数。 有効なデータ型については、 Type プロパティを参照してください。 |
Value |
省略可能 |
バリアント型 (Variant) |
初期プロパティ値を格納しているバリアント型 ( Variant ) の値。 詳細については、 Value プロパティを参照してください。 |
DDL |
省略可能 |
バリアント型 (Variant) |
Property が DDL オブジェクトであるかどうかを示す、サブタイプがブール型 (Boolean) であるバリアント型 (Variant) の値。 既定値は False です。 DDL が True の場合、ユーザーは dbSecWriteDef アクセス許可を持っていない限り、この Property オブジェクトを変更または削除できません。 |
戻り値
プロパティ
注釈
ユーザー定義の Property オブジェクトを作成できるのは、持続的なオブジェクトの Properties コレクション内だけです。
CreateProperty を使用するときに 1 つ以上の省略可能な引数を省略した場合は、新しいオブジェクトをコレクションに追加する前に、適切な代入ステートメントを使用して、対応するプロパティを設定またはリセットできます。 オブジェクトをコレクションに追加した後は、一部のプロパティ設定を変更できなくなります。 詳細については、 Name、 Type、および Value の各プロパティのトピックを参照してください。
name が既にコレクションのメンバーであるオブジェクトを参照している場合、 Append メソッドを使用すると実行時エラーが発生します。
ユーザー定義の Property オブジェクトをコレクションから削除するには、 Properties コレクションの Delete メソッドを使用します。 組み込みのプロパティは削除できません。
注:
DDL 引数を省略すると、既定では False (DDL 以外) になります。 対応する DDL プロパティが公開されていないため、DDL から DDL 以外に変更する Property オブジェクトを削除して再作成する必要があります。