OracleParameter.Size OracleParameter.Size OracleParameter.Size OracleParameter.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); };
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. 既定値は 0 です (値の最大サイズを指定しない場合に使用されます)。The default value is 0 (to be used when you do not want to specify the maximum size of the value).

実装

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

Public Sub CreateOracleParameter()  
   Dim parameter As New OracleParameter("pDescription", OracleType.VarChar)  
   parameter.IsNullable = True  
   parameter.Direction = ParameterDirection.Output  
   parameter.Size = 88  
End Sub  
public void CreateOracleParameter()   
{  
   OracleParameter parameter = new OracleParameter("pDescription", OracleType.VarChar);  
   parameter.IsNullable = true;  
   parameter.Direction = ParameterDirection.Output;  
   parameter.Size = 88;  
}  

注釈

設定Size入力パラメーターの値のみに影響します。Setting Size affects only the input value of a parameter. 戻り値と出力パラメーターは、このプロパティによる影響はありません。Return values and output parameters are not affected by this property.

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 one hundred characters.

双方向と出力のパラメーターと戻り値は、サイズの値を設定する必要があります。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.

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

適用対象