OleDbParameter.Size プロパティ

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

パッケージ:

System.Data.OleDb v9.0.0-rc.2.24473.5

ソース:

DbParameterHelper.cs

列内のデータの最大サイズ (バイト) を取得または設定します。

public:
 virtual property int Size { int get(); void set(int value); };

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

プロパティ値

Int32

列内のデータの最大サイズ (バイト) です。 既定値はパラメーター値から推論されます。

実装

Size

例

次の例では、 を OleDbParameter 作成し、そのプロパティの一部を設定します。

Public Sub CreateOleDbParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub 'CreateOleDbParameter  

public void CreateOleDbParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);  
    parameter.Direction = ParameterDirection.Output;  
    parameter.Size = myValue.Length;  
    parameter.Value = myValue;  
 }  

注釈

プロパティは Size 、バイナリ型と文字列型に使用されます。

文字列以外のデータ型と ANSI 文字列データの場合、 プロパティは Size バイト数を参照します。 Unicode 文字列データの場合、 Size は文字数を参照します。 文字列のカウントには、終了文字は含まれません。

可変長データ型の場合は、 Size サーバーに送信するデータの最大量を記述します。 たとえば、Unicode 文字列値の場合は、 を使用して、 Size サーバーに送信されるデータの量を最初の 100 文字に制限できます。

双方向パラメーターと出力パラメーターと戻り値の場合は、 の Size値を設定する必要があります。 これは入力パラメーターには必要ありません。明示的に設定されていない場合、 の値は、パラメーター化されたステートメントの実行時に、指定されたパラメーターの実際のサイズから推論されます。

パラメーターの 、OleDbType、および Size プロパティはDbType、 を設定Valueすることで推論できます。 そのため、指定する必要はありません。 ただし、プロパティ設定では OleDbParameter 公開されません。 たとえば、 パラメーターのサイズが推論された場合、 Size にはステートメントの実行後に推論された値が含まれません。

固定長データ型の場合、 の Size 値は無視されます。 これは情報提供のために取得でき、パラメーターの値をサーバーに送信するときにプロバイダーが使用する最大バイト数を返します。

に指定されたOleDbParameter値のサイズが指定した Sizeを超える場合、 の OleDbParameter にはValue指定した値が格納され、 のOleDbParameterサイズに切り捨てられます。

こちらもご覧ください

• コマンドの操作