OleDbParameter.Size Eigenschap

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, set

member this.Size : int with get, set

Public Property Size As Integer

Public Overrides Property Size As Integer

Waarde van eigenschap

De maximale grootte, in bytes, van de gegevens in de kolom. De standaardwaarde wordt afgeleid van de parameterwaarde.

Implementeringen

Kenmerken

DataSysDescriptionAttribute

Voorbeelden

In het volgende voorbeeld wordt een OleDbParameter aantal eigenschappen gemaakt en ingesteld.

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;
 }

Opmerkingen

De Size eigenschap wordt gebruikt voor binaire en tekenreekstypen.

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 worden verzonden, te beperken tot de eerste 100 tekens.

Voor bidirectionele en uitvoerparameters en retourwaarden moet u de waarde van Size. Dit is niet vereist voor invoerparameters en als deze niet expliciet is ingesteld, wordt de waarde afgeleid van de werkelijke grootte van de opgegeven parameter wanneer een geparameteriseerde instructie wordt uitgevoerd.

De DbType, OleDbTypeen Size eigenschappen van een parameter kunnen worden afgeleid door de instelling Value. Daarom hoeft u ze niet op te geven. Ze worden echter niet weergegeven in OleDbParameter eigenschapsinstellingen. Als de grootte van de parameter bijvoorbeeld is afgeleid, Size bevat deze niet de uitgestelde waarde na de uitvoering van de instructie.

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.

Als de grootte van de opgegeven OleDbParameter waarde groter is dan de opgegeven Sizewaarde, bevat de Value van de OleDbParameter opgegeven waarde, afgekapt tot de grootte van de OleDbParameter.

Zie ook

• Werken met opdrachten