次の方法で共有

OdbcParameter.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);

プロパティ値

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

実装

IDbDataParameter.Size

解説

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

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

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

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

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

メモ    Direction が ParameterDirection.Output 、 ParameterDirection.InputOutput 、または ParameterDirection.ReturnValue の OdbcParameter では、コマンドが実行され、データ ソースから返された値のサイズが OdbcParameter の Size で指定した値を超えると、例外がスローされます。

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

使用例

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

 
Public Sub CreateOdbcParameter()
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
    Dim myParameter As New OdbcParameter("Description", OdbcType.VarChar)
    myParameter.Direction = ParameterDirection.Output
    myParameter.Size = myValue.Length
    myParameter.Value = myValue
End Sub 'CreateAdoParameter

[C#] 
public void CreateOdbcParameter() 
 {
    string myValue = "12 foot scarf - multiple colors, one previous owner";
    OdbcParameter myParameter = new OdbcParameter("Description", OdbcType.VarChar);
    myParameter.Direction = ParameterDirection.Output;
    myParameter.Size = myValue.Length;
    myParameter.Value = myValue;
 }

[C++] 
public:
    void CreateOdbcParameter()
    {
        String* myValue = S"12 foot scarf - multiple colors, one previous owner";
        OdbcParameter* myParameter = new OdbcParameter(S"Description", OdbcType::VarChar);
        myParameter->Direction = ParameterDirection::Output;
        myParameter->Size = myValue->Length;
        myParameter->Value = myValue;
    };

[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 ファミリ

参照

OdbcParameter クラス | OdbcParameter メンバ | System.Data.Odbc 名前空間