SqlParameter.Size Tulajdonság

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.SqlClient.dll
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

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

Int32

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

Size
Attribútumok
DataSysDescriptionAttribute

Példák

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

static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.InputOutput;
    parameter.Size = description.Length;
    parameter.Value = description;
}

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

Megjegyzések

A visszatérési értékeket ez a tulajdonság nem befolyásolja; A tárolt eljárásokból származó visszatérési paraméterek mindig rögzített méretű egész számok.

Változó hosszúságú (például nvarchar) kimeneti paraméterek esetén a paraméter mérete határozza meg a kimeneti paramétert tartalmazó puffer méretét. A kimeneti paraméter csonkolt a megadott Sizeméretre. Karaktertípusok esetén a megadott méret karakterekben van megadva Size .

A Size tulajdonság bináris és sztringtípusokhoz használható. A típusparaméterek SqlType.StringSize esetében a Unicode-karakterek hossza. A típusparaméterek SqlType.XmlSize esetében a rendszer figyelmen kívül hagyja.

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.

Ha nincs explicit módon beállítva, a rendszer a megadott paraméterérték tényleges méretéből következtet.

Ha a paraméterérték tört része nagyobb, mint a méret, akkor a rendszer csonkolja az értéket a méretnek megfelelően.

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.

A streamelésről további információt az SqlClient streamelési támogatásában talál.

A következőre érvényes:

Lásd még