OracleParameter.Size プロパティ

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

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

public int Size { get; set; }

public override int Size { get; set; }

member this.Size : int with get, set

Public Property Size As Integer

Public Overrides Property Size As Integer

プロパティ値

列内のデータの最大サイズ (バイト単位)。 既定値は 0 です (値の最大サイズを指定しない場合に使用します)。

実装

例

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

Public Sub CreateOracleParameter()
   Dim parameter As New OracleParameter("pDescription", OracleType.VarChar)
   parameter.IsNullable = True
   parameter.Direction = ParameterDirection.Output
   parameter.Size = 88
End Sub

public void CreateOracleParameter()
{
   OracleParameter parameter = new OracleParameter("pDescription", OracleType.VarChar);
   parameter.IsNullable = true;
   parameter.Direction = ParameterDirection.Output;
   parameter.Size = 88;
}

注釈

Size設定は、パラメーターの入力値にのみ影響します。 戻り値と出力パラメーターは、このプロパティの影響を受けません。

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

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

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

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

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

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