SqlParameter.Size Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de maximale grootte, in bytes, van de gegevens in de kolom opgehaald of ingesteld.
public:
property int Size { int get(); void set(int value); };public:
virtual property int Size { int get(); void set(int value); };[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }public override int Size { get; set; }[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setmember this.Size : int with get, setPublic Property Size As IntegerPublic Overrides Property Size As IntegerWaarde van eigenschap
De maximale grootte, in bytes, van de gegevens in de kolom. De standaardwaarde wordt afgeleid van de parameterwaarde.
Implementeringen
- Kenmerken
Voorbeelden
In het volgende voorbeeld wordt een SqlParameter aantal eigenschappen gemaakt en ingesteld.
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
Opmerkingen
Retourwaarden worden niet beïnvloed door deze eigenschap; retourparameters van opgeslagen procedures zijn altijd gehele getallen met een vaste grootte.
Voor uitvoerparameters met een type variabele lengte (bijvoorbeeld nvarchar) definieert de grootte van de parameter de grootte van de buffer die de uitvoerparameter bevat. De uitvoerparameter kan worden afgekapt tot een opgegeven grootte met Size. Voor tekentypen is de opgegeven Size grootte in tekens.
De Size eigenschap wordt gebruikt voor binaire en tekenreekstypen. Voor parameters van het type SqlType.StringSize betekent lengte in Unicode-tekens. Voor parameters van het type SqlType.Xmlwordt Size genegeerd.
Voor niet-tekenreeksgegevens en ANSI-tekenreeksgegevens verwijst de Size eigenschap naar het aantal bytes. Voor Unicode-tekenreeksgegevens Size verwijst u naar het aantal tekens. Het aantal tekenreeksen bevat niet het afsluitteken.
Voor gegevenstypen Size met een variabele lengte wordt de maximale hoeveelheid gegevens beschreven die naar de server moet worden verzonden. Voor een Unicode-tekenreekswaarde Size kan bijvoorbeeld worden gebruikt om de hoeveelheid gegevens die naar de server wordt verzonden, te beperken tot de eerste honderd tekens.
Als deze niet expliciet is ingesteld, wordt de grootte afgeleid van de werkelijke grootte van de opgegeven parameterwaarde.
Als het breukgedeelte van de parameterwaarde groter is dan de grootte, wordt de waarde afgekapt zodat deze overeenkomt met de grootte.
Voor gegevenstypen met een vaste lengte wordt de waarde genegeerd Size . Het kan worden opgehaald voor informatieve doeleinden en retourneert de maximale hoeveelheid bytes die de provider gebruikt bij het verzenden van de waarde van de parameter naar de server.
Zie Ondersteuning voor streaming van SqlClient voor meer informatie over streaming.