次の方法で共有

OleDbParameter.Size プロパティ

  • [アーティクル]

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

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

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

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

使用例

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

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

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

[C++] 
public:
void CreateOleDbParameter() 
 {
    String* myValue = S"12 foot scarf - multiple colors, one previous owner";
    OleDbParameter* myParameter = new OleDbParameter(S"Description", OleDbType::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 ファミリ

参照

OleDbParameter クラス | OleDbParameter メンバ | System.Data.OleDb 名前空間