SqlParameter.Size SqlParameter.Size SqlParameter.Size SqlParameter.Size Property

定義

列内のデータの最大サイズをバイト単位で取得または設定します。Gets or sets the maximum size, in bytes, of the data within the column.

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

プロパティ値

列内のデータの最大サイズ (バイト単位)。The maximum size, in bytes, of the data within the column. 既定値はパラメーター値から推論されます。The default value is inferred from the parameter value.

実装

次の例ではSqlParameter 、を作成し、そのプロパティの一部を設定します。The following example creates a SqlParameter and sets some of its properties.

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

注釈

戻り値は、このプロパティの影響を受けません。ストアドプロシージャからの戻り値のパラメーターは、常に固定サイズの整数です。Return values are not affected by this property; return parameters from stored procedures are always fixed-size integers.

可変長型の出力パラメーター (たとえば、nvarchar) の場合、パラメーターのサイズによって、出力パラメーターを保持するバッファーのサイズが定義されます。For output parameters with a variable length type (nvarchar, for example), the size of the parameter defines the size of the buffer holding the output parameter. 出力パラメーターは、でSize指定したサイズに切り捨てることができます。The output parameter can be truncated to a size specified with Size. 文字型の場合、でSize指定されたサイズは文字単位です。For character types, the size specified with Size is in characters.

プロパティSizeは、バイナリ型および文字列型に使用されます。The Size property is used for binary and string types. SqlType.Stringのパラメーターの場合Size 、は Unicode 文字の長さを意味します。For parameters of type SqlType.String, Size means length in Unicode characters. SqlType.Xmlのパラメーターの場合Size 、は無視されます。For parameters of type SqlType.Xml, Size is ignored.

文字列以外のデータ型と ANSI 文字列データのSize場合、プロパティはバイト数を参照します。For nonstring data types and ANSI string data, the Size property refers to the number of bytes. Unicode 文字列データの場合Size 、は文字数を示します。For Unicode string data, Size refers to the number of characters. 文字列の数には、終端文字は含まれません。The count for strings does not include the terminating character.

可変長データ型の場合は、 Sizeサーバーに送信するデータの最大量を記述します。For variable-length data types, Size describes the maximum amount of data to transmit to the server. たとえば、Unicode 文字列値の場合、をSize使用して、サーバーに送信されるデータの量を最初の100文字に制限することができます。For example, for a Unicode string value, Size could be used to limit the amount of data sent to the server to the first one hundred characters.

明示的に設定しない場合、サイズは指定されたパラメーター値の実際のサイズから推定されます。If not explicitly set, the size is inferred from the actual size of the specified parameter value.

パラメーター値の小数部がサイズより大きい場合、値はサイズに合わせて切り捨てられます。If the fractional part of the parameter value is greater than the size, then the value will be truncated to match the size.

固定長データ型の場合、のSize値は無視されます。For fixed length data types, the value of Size is ignored. これは情報提供を目的として取得できます。また、パラメーターの値をサーバーに送信するときに、プロバイダーが使用する最大バイト数を返します。It can be retrieved for informational purposes, and returns the maximum amount of bytes the provider uses when transmitting the value of the parameter to the server.

ストリーミングの詳細については、「 SqlClient Streaming Support」を参照してください。For information about streaming, see SqlClient Streaming Support.

適用対象

こちらもご覧ください