次の方法で共有


OracleParameter.Size プロパティ

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

Public Overridable Property Size As Integer  Implements _   IDbDataParameter.Size
[C#]
public virtual int Size {get; set;}
[C++]
public: __property virtual int get_Size();public: __property virtual void set_Size(int);
[JScript]
public function get Size() : int;public function set Size(int);

プロパティ値

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

実装

IDbDataParameter.Size

解説

Size を設定した場合、パラメータの入力値だけが影響を受けます。戻り値と出力パラメータがこのプロパティによって影響を受けることはありません。

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

文字列以外のデータ型および ANSI 文字列データでは、 Size プロパティは、バイト数を示します。Unicode 文字列データでは、 Size は、文字数を示します。文字列の文字数に、終端文字は含まれません。

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

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

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

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

使用例

[Visual Basic, C#, C++] OracleParameter を作成し、そのプロパティの一部を設定する例を次に示します。

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

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

[C++] 
public:
void CreateOracleParameter() 
 {
    OracleParameter* myParameter = new OracleParameter(S"pDescription", OracleType::VarChar);
    myParameter->IsNullable = true;
    myParameter->Direction = ParameterDirection::Output;
    myParameter->Size = 88;
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

OracleParameter クラス | OracleParameter メンバ | System.Data.OracleClient 名前空間