SqlParameter.Size Egenskap

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.SqlClient.dll
Sammansättning:
System.Data.dll
Källa:
System.Data.SqlClient.notsupported.cs

Hämtar eller anger den maximala storleken, i byte, på data i kolumnen.

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

Egenskapsvärde

Int32

Den maximala storleken, i byte, på data i kolumnen. Standardvärdet härleds från parametervärdet.

Implementeringar

Size
Attribut
DataSysDescriptionAttribute

Exempel

I följande exempel skapas en SqlParameter och vissa av dess egenskaper anges.

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

Kommentarer

Returvärden påverkas inte av den här egenskapen. returparametrar från lagrade procedurer är alltid heltal med fast storlek.

För utdataparametrar med en variabellängdstyp (t.ex. nvarchar) definierar parameterns storlek storleken på bufferten som innehåller utdataparametern. Utdataparametern kan trunkeras till en storlek som anges med Size. För teckentyper är den storlek som anges med Size tecken.

Egenskapen Size används för binär- och strängtyper. För parametrar av typen SqlType.Stringbetyder betyder Size längden i Unicode-tecken. För parametrar av typen SqlType.XmlSize ignoreras.

För icke-strängdatatyper och ANSI-strängdata Size refererar egenskapen till antalet byte. För Unicode-strängdata Size refererar till antalet tecken. Antalet för strängar inkluderar inte avslutande tecken.

För datatyper med Size variabel längd beskriver den maximala mängden data som ska överföras till servern. För ett Unicode-strängvärde Size kan till exempel användas för att begränsa mängden data som skickas till servern till de första hundra tecknen.

Om den inte uttryckligen anges härleds storleken från den faktiska storleken på det angivna parametervärdet.

Om deldelen av parametervärdet är större än storleken trunkeras värdet så att det matchar storleken.

För datatyper med fast längd ignoreras värdet Size för. Den kan hämtas i informationssyfte och returnerar den maximala mängden byte som providern använder när värdet för parametern överförs till servern.

Information om strömning finns i Stöd för SqlClient-direktuppspelning.

Gäller för

Se även