次の方法で共有

SqlParameter.Size プロパティ

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll
ソース:
System.Data.SqlClient.notsupported.cs

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

public:
 virtual property int Size { int get(); void set(int value); };
public:
 property int Size { int get(); void set(int value); };
public override int Size { get; set; }
[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }
member this.Size : int with get, set
[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

プロパティ値

Int32

列内のデータの最大サイズ (バイト単位)。 既定値はパラメーター値から推論されます。

実装

Size
属性
DataSysDescriptionAttribute

例

次の例では、 SqlParameter を作成し、そのプロパティの一部を設定します。

static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.InputOutput;
    parameter.Size = description.Length;
    parameter.Value = description;
}

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

注釈

戻り値は、このプロパティの影響を受けません。ストアド プロシージャからの戻りパラメーターは常に固定サイズの整数です。

可変長型 (nvarchar など) の出力パラメーターの場合、パラメーターのサイズによって、出力パラメーターを保持するバッファーのサイズが定義されます。 出力パラメーターは、 Sizeで指定されたサイズに切り捨てることができます。 文字型の場合、 Size で指定されたサイズは文字単位です。

Size プロパティは、バイナリ型と文字列型に使用されます。 SqlType.String型のパラメーターの場合、Sizeは Unicode 文字の長さを意味します。 SqlType.Xml型のパラメーターの場合、Sizeは無視されます。

文字列以外のデータ型と ANSI 文字列データの場合、 Size プロパティはバイト数を参照します。 Unicode 文字列データの場合、 Size は文字数を参照します。 文字列の数には、終了文字は含まれません。

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

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

パラメーター値の小数部がサイズより大きい場合、値はサイズと一致するように切り捨てられます。

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

ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

適用対象

こちらもご覧ください