OleDbParameter.Size-Eigenschaft

Ruft die maximale Größe der Daten innerhalb der Spalte in Bytes ab oder legt diese fest.

Namespace: System.Data.OleDb
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Property Size As Integer
'Usage
Dim instance As OleDbParameter
Dim value As Integer

value = instance.Size

instance.Size = value

public override int Size { get; set; }

public:
virtual property int Size {
    int get () override;
    void set (int value) override;
}

/** @property */
public int get_Size ()

/** @property */
public void set_Size (int value)

public override function get Size () : int

public override function set Size (value : int)

Eigenschaftenwert

Die maximale Größe der Daten in der Spalte in Bytes. Der Standardwert wird aus dem Parameterwert hergeleitet.

Hinweise

Die Size-Eigenschaft wird für Binär- und Zeichenfolgentypen verwendet.

Bei Datentypen, die keine Zeichenfolgen sind, sowie bei ANSI-Zeichenfolgendaten bezieht sich die Size-Eigenschaft auf die Anzahl der Bytes. Bei Unicode-Zeichenfolgendaten bezieht sich Size auf die Anzahl der Zeichen. Die Zählung für Zeichenfolgen schließt das abschließende Zeichen nicht mit ein.

Bei Datentypen mit variabler Länge beschreibt Size die maximale Datenmenge, die an den Server übermittelt wird. Für einen Unicode-Zeichenfolgenwert kann z. B. die Menge der an den Server gesendeten Daten mit Size auf die ersten 100 Zeichen beschränkt werden.

Für bidirektionale Parameter, Ausgabeparameter und Rückgabewerte müssen Sie den Wert von Size festlegen. Dies ist bei Eingabeparametern nicht erforderlich. Wenn dort der Wert nicht explizit festgelegt wird, wird er beim Ausführen einer parametrisierten Anweisung aus der tatsächlichen Größe des angegebenen Parameters hergeleitet.

Die Eigenschaften DbType, OleDbType und Size eines Parameters können durch Festlegen von Value abgeleitet werden. Daher müssen Sie diese nicht angeben. Sie werden aber nicht in den OleDbParameter-Eigenschafteneinstellungen verfügbar gemacht. Wenn z. B. die Größe des Parameters abgeleitet wurde, enthält Size nach dem Ausführen der Anweisung keinen abgeleiteten Wert.

Bei Datentypen mit fester Länge wird der Wert von Size ignoriert. Er kann zu Informationszwecken abgerufen werden und gibt die maximale Menge von Bytes zurück, die der Provider beim Übermitteln des Parameterwerts an den Server verwendet.

Wenn die Größe des für einen OleDbParameter bereitgestellten Werts die angegebene Size überschreitet, enthält der Value des OleDbParameter den angegebenen Wert, abgeschnitten auf die Größe des OleDbParameter.

Beispiel

Im folgenden Beispiel wird ein OleDbParameter erstellt, und einige seiner Eigenschaften werden festgelegt.

[Visual Basic]

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

[C#]

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

OleDbParameter-Klasse
OleDbParameter-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen