DbParameter.Size Tulajdonság

Definíció

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

public:
 abstract property int Size { int get(); void set(int value); };
public abstract int Size { get; set; }
member this.Size : int with get, set
Public MustOverride 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

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ő száz 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, az érték a paraméteres utasítás végrehajtásakor a megadott paraméter tényleges méretéből következik.

Egy DbType paraméter é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 DbParameter . Ha például a paraméter mérete kikövetkeztetett, Size akkor nem tartalmaz 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 a megadott DbParameter érték mérete meghaladja a megadott Sizeértéket, akkor a ValueDbParameter megadott érték lesz a megadott érték, amely csonkolt a méretére DbParameter.

A .DbTypetípusú Stringparaméterek esetében a Size hosszúság Unicode-karakterekben van megadva. A .DbTypeXmltípusú Sizeparaméterek figyelmen kívül lesznek hagyva.

A következőre érvényes:

Lásd még