OleDbParameter.Size Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
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.