AdditionalParms プロパティ

Public Property AdditionalParms As String

public string AdditionalParms {get;set;}

ArgumentException 値に無効な接続文字列が含まれていました。

ここで指定されるのは、使用頻度の低いパラメーターです。

「キーワード=値」をセミコロンで区切ったリストによる追加のパラメーター。「キーワード=値」リストの値は、ULConnection.ConnectionString のルールに従う必要があります。デフォルトは NULL 参照 (Visual Basic の Nothing) です。

ページサイズや予約サイズのパラメーターの値は、バイト単位で指定します。キロバイトの単位を示すにはサフィックス k または K を使用し、メガバイトの単位を示すにはサフィックス m または M を使用します。

追加のパラメーターを次に示します。

キーワード	説明
dbn	接続する必要のある、ロードしたデータベースを識別します。データベースが起動されると、データベース名が割り当てられます。データベース名は、dbn パラメーターを使用して明示的に割り当てられるか、または拡張子とパスが削除されたベースファイル名を使用して Ultra Light によって割り当てられます。接続が開かれると、Ultra Light は dbn 値が一致する実行中のデータベースをまず検索します。一致するデータベースが見つからない場合、Ultra Light は適切なデータベースのファイル名のパラメーター (DatabaseOnDevice プロパティまたは DatabaseOnDesktop プロパティを持つ) を使用して、新しいデータベースを起動します。このパラメーターが必要なのは、同じベースファイル名を持つ 2 つの異なるデータベースにアプリケーション (または Ultra Light エンジン) がアクセスする場合です。このパラメーターが使用されるのは、ULConnection.Open メソッドを使用して接続を開いたときだけです。
reserve_size	Ultra Light の永続的データの保管に使用する、ファイルシステム領域を予約します。reserve_size パラメーターを使用すると、データを挿入することなく、Ultra Light データベースが必要とするファイルシステム領域を事前に割り付けることができます。ファイルシステムの領域を予約すると、パフォーマンスが多少向上し、メモリが不足するという障害を防ぐことができます。デフォルトでは、永続ストアファイルのサイズは、アプリケーションがデータベースを更新して、サイズを大きくする必要が生じた場合にだけ大きくなります。reserve_size パラメーターで予約されるファイルシステム領域には、未加工データだけでなく、永続ストアファイルのメタデータも含まれることに注意してください。データベースのデータ量から、必要なファイルシステム領域を計算する場合は、メタデータのオーバーヘッドとデータの圧縮を考慮してください。reserve_size パラメーターは、起動時に永続ストアファイルを設定された予約サイズまで大きくすることにより、領域を予約します。これは、そのファイルが以前に存在していたかどうかに関係なく行われます。このファイルはトランケートされません。パラメーター文字列 createParms.AdditionalParms = "reserve_size=2m" で、起動時に継続保管ファイルが少なくとも 2 MB であることが保証されます。このパラメーターは、ULConnection.Open メソッドで接続開くときにのみ使用されます。
start	ロケーションを指定して、Ultra Light エンジンを開始します。現在実行中でないエンジンに接続する場合は、StartLine (START) 接続パラメーターだけを指定します。ロケーションの指定は、Ultra Light エンジンがシステムパスに登録されていない場合にのみ必要です。

AdditionalParms プロパティ

Visual Basic 構文

C# 構文

例外

備考

参照