OdbcParameter.Size 屬性

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v9.0.0-preview.3.24172.9

來源:

OdbcParameterHelper.cs

取得或設定資料行中資料的最大大小。

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

屬性值

Int32

資料行中資料的最大大小。 預設值是由參數值推斷。

實作

Size

範例

下列範例會建立 並 OdbcParameter 設定其部分屬性。

Public Sub CreateOdbcParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub   

public void CreateOdbcParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OdbcParameter parameter = new OdbcParameter("Description", OdbcType.VarChar);  
    parameter.Direction = ParameterDirection.Output;  
    parameter.Size = myValue.Length;  
    parameter.Value = myValue;  
 }  

備註

屬性 Size 用於二進位和字串類型。

針對非字串數據類型和 ANSI 字串資料， Size 屬性會參考位元元組數目。 若為 Unicode 字串數據， Size 請參閱字元數。 字串的計數不包含終止字元。

針對可變長度數據類型， Size 描述要傳輸至伺服器的最大數據量。 例如，針對 Unicode 字串值， Size 可用來將傳送至伺服器的數據量限制為前一百個字元。

針對雙向和輸出參數，以及傳回值，您必須設定的值 Size。 這並非輸入參數的必要專案，如果未明確設定，則會在執行參數化語句時，從指定參數的實際大小推斷 的值。

DbType您可以藉由設定 Value來推斷參數的、 OdbcType和 Size 屬性。 因此，您不需要指定它們。 不過，它們不會在屬性設定中 OdbcParameter 公開。 例如，如果已推斷參數的大小， Size 則不會在語句執行之後包含推斷的值。

注意

OdbcParameter對於 具有 Direction 、 ParameterDirection.InputOutput或 ParameterDirection.ReturnValue的 ParameterDirection.Output，如果數據源傳回的值大小超過 SizeOdbcParameter指定的 ，則會擲回例外狀況。

若為固定長度數據類型，則會忽略的值 Size 。 它可以擷取以供參考之用，並傳回提供者在將 參數值傳送至伺服器時所使用的位元組數量上限。

另請參閱

• 使用命令