OdbcParameter.Size-Eigenschaft

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

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

Syntax

'Declaration
Public Overrides Property Size As Integer
'Usage
Dim instance As OdbcParameter
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. 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 hundert 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, OdbcType und Size eines Parameters können durch Festlegen von Value hergeleitet werden. Daher müssen Sie diese nicht angeben. Sie werden aber nicht in den OdbcParameter-Eigenschafteneinstellungen verfügbar gemacht. Wenn z. B. die Größe des Parameters hergeleitet wurde, enthält Size nach dem Ausführen der Anweisung keinen hergeleiteten Wert.

Hinweis

Für einen OdbcParameter mit einer Direction von ParameterDirection.Output, ParameterDirection.InputOutput oder ParameterDirection.ReturnValue wird beim Ausführen des Befehls eine Ausnahme ausgelöst, wenn die Größe des von der Datenquelle zurückgegebenen Werts die angegebene Size des OdbcParameter übersteigt.

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 Parameter an den Server verwendet.

Beispiel

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

[Visual Basic]

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 

[C#]

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

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

Siehe auch

Referenz

OdbcParameter-Klasse
OdbcParameter-Member
System.Data.Odbc-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen