OleDbParameter.Size OleDbParameter.Size OleDbParameter.Size OleDbParameter.Size Property

定義

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

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

プロパティ値

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

実装

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

Public Sub CreateOleDbParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub 'CreateOleDbParameter  
public void CreateOleDbParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);  
    parameter.Direction = ParameterDirection.Output;  
    parameter.Size = myValue.Length;  
    parameter.Value = myValue;  
 }  

注釈

Sizeバイナリおよび文字列型のプロパティを使用します。The Size property is used for binary and string types.

文字列以外のデータ型と 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 100 characters.

双方向と出力のパラメーターと戻り値は、の値を設定する必要がありますSizeします。For bidirectional and output parameters, and return values, you must set the value of Size. 入力パラメーターは、必要でないかどうかを明示的に設定の値から推論されます、指定されたパラメーターの実際のサイズ パラメーター化されたステートメントを実行するとします。This is not required for input parameters, and if not explicitly set, the value of is inferred from the actual size of the specified parameter when a parameterized statement is executed.

DbTypeOleDbType、およびSize設定で、パラメーターのプロパティを推測できなければValueします。The DbType, OleDbType, and Size properties of a parameter can be inferred by setting Value. そのため、それらを指定する必要はありません。Therefore, you are not required to specify them. ただし、これらはでOleDbParameterプロパティの設定。However, they are not exposed in OleDbParameter property settings. たとえば、次のパラメーターのサイズが推論Sizeステートメントの実行後に推定値が含まれていません。For example, if the size of the parameter has been inferred, Size does not contain the inferred value after statement execution.

固定長のデータ型の値の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.

値のサイズが指定されている場合、 OleDbParameter 、指定値を超えたSizeValueOleDbParameterのサイズに切り捨てられます、指定した値が含まれています、OleDbParameterします。If the size of the value supplied for an OleDbParameter exceeds the specified Size, the Value of the OleDbParameter contains the specified value, truncated to the size of the OleDbParameter.

適用対象

こちらもご覧ください