DbParameter.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:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride 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
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 en 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 DbParameter eigenschapsinstellingen. Als de grootte van de parameter bijvoorbeeld is afgeleid, Size bevat deze geen 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 DbParameter waarde groter is dan de opgegeven Sizewaarde, bevat het Value van de DbParameter opgegeven waarde, afgekapt tot de grootte van de DbParameter.
Voor parameters van het type DbType.Stringis de waarde van Size de lengte in Unicode-tekens. Voor parameters van het type DbType.Xml, Size wordt genegeerd.