OleDbParameter.Size Tulajdonság

Definíció

Lekéri vagy beállítja az oszlopban lévő adatok maximális méretét bájtban.

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

Tulajdonság értéke

Az oszlopban lévő adatok maximális mérete bájtban. Az alapértelmezett érték a paraméterértékből származik.

Megvalósítás

Attribútumok

Példák

Az alábbi példa létrehoz és OleDbParameter beállít néhány tulajdonságot.

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;
 }

Megjegyzések

A Size tulajdonság bináris és sztringtípusokhoz használható.

A nem sztringes adattípusok és az ANSI-sztringadatok esetében a Size tulajdonság a bájtok számát jelenti. Unicode-sztringadatok Size esetén a karakterek számát kell megadni. A sztringek száma nem tartalmazza a végződő karaktert.

A változó hosszúságú adattípusok Size esetében a kiszolgálónak továbbítandó adatok maximális mennyiségét írja le. Unicode-sztringérték Size esetén például a kiszolgálónak küldött adatok mennyiségét az első 100 karakterre korlátozhatja.

A kétirányú és kimeneti paraméterek, valamint a visszaadott értékek esetében a következő értéket kell megadnia Size: . Ez a bemeneti paraméterek esetében nem kötelező, és ha nincs explicit módon beállítva, a paraméteres utasítás végrehajtásakor a paraméter értéke a megadott paraméter tényleges méretéből következik.

A DbTypeparaméter , OleDbTypeés Size tulajdonságai a beállítással Valuekövetkeztethetők. Ezért nem kell megadnia őket. Ezek azonban nem jelennek meg a tulajdonságbeállításokban OleDbParameter . Ha például a paraméter mérete kikövetkeztetett, Size akkor nem tartalmazza az utasítás végrehajtása után kikövetkeztetett értéket.

Rögzített hosszúságú adattípusok esetén a rendszer figyelmen kívül hagyja az értékeket Size . Lekérhető tájékoztatás céljából, és visszaadja a szolgáltató által a paraméter értékének a kiszolgálónak történő továbbításához használt maximális bájtmennyiséget.

Ha egy adott értékhez OleDbParameter megadott érték mérete meghaladja a megadott Sizeértéket, akkor a ValueOleDbParameter megadott érték csonkolt a megadott értékhez OleDbParameter.

A következőre érvényes:

Lásd még