OracleParameter.Size プロパティ

定義

名前空間:

System.Data.OracleClient

アセンブリ:

System.Data.OracleClient.dll

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

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

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

実装

Size

例

次の例では、 を 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 の値を設定する必要があります。 これは入力パラメーターには必要ありません。明示的に設定されていない場合、 の値は、パラメーター化されたステートメントの実行時に、指定されたパラメーターの実際のサイズから推論されます。

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

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