OdbcParameter.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 van de gegevens in de kolom opgehaald of ingesteld.
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; }public int Size { get; set; }member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerWaarde van eigenschap
De maximale grootte van de gegevens in de kolom. De standaardwaarde wordt afgeleid van de parameterwaarde.
Implementeringen
Voorbeelden
In het volgende voorbeeld wordt een OdbcParameter aantal eigenschappen gemaakt en ingesteld.
Public Sub CreateOdbcParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OdbcParameter parameter = new OdbcParameter("Description", OdbcType.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 wordt verzonden, te beperken tot de eerste honderd 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, OdbcTypeen 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 OdbcParameter eigenschapsinstellingen. Als de grootte van de parameter bijvoorbeeld is afgeleid, Size bevat deze geen uitgestelde waarde na de uitvoering van de instructie.
Note
Voor een OdbcParameter met een Direction vanParameterDirection.Output, ParameterDirection.InputOutputof , ofParameterDirection.ReturnValue, wordt er een uitzondering gegenereerd wanneer de opdracht wordt uitgevoerd als de grootte van de waarde die door de gegevensbron wordt geretourneerd, groter is dan de Sizeopgegeven OdbcParameter waarde .
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.
