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

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

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

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

明示的に設定しなかった場合、サイズは、指定したパラメータ値の実際のサイズから推論されます。

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

使用例

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

 
Public Sub CreateSqlParameter()
    Dim myParameter As New SqlParameter("@Description", SqlDbType.VarChar)
    myParameter.IsNullable = True
    myParameter.Direction = ParameterDirection.Output
    myParameter.Size = 88
End Sub 'CreateSqlParameter

[C#] 
public void CreateSqlParameter() 
 {
    SqlParameter myParameter = new SqlParameter("@Description", SqlDbType.VarChar);
    myParameter.IsNullable = true;
    myParameter.Direction = ParameterDirection.Output;
    myParameter.Size = 88;
 }

[C++] 
public:
void CreateSqlParameter() 
 {
    SqlParameter* myParameter = new SqlParameter(S"@Description", SqlDbType::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 Compact Framework - Windows CE .NET

参照

SqlParameter クラス | SqlParameter メンバ | System.Data.SqlClient 名前空間