SqlParameter.Size-Eigenschaft

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

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

Syntax

'Declaration
Public Overrides Property Size As Integer
'Usage
Dim instance As SqlParameter
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

Das Festlegen von Size hat nur Auswirkungen auf den Eingabewert eines Parameters. Auf Rückgabewerte und Ausgabeparameter hat diese Eigenschaft keine Auswirkungen.

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.

Wenn die Größe nicht explizit festgelegt wurde, wird sie aus der tatsächlichen Größe des angegebenen Parameter hergeleitet.

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 SqlParameter erstellt, und einige seiner Eigenschaften werden festgelegt.

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = description.Length
    parameter.Value = description
End Sub

static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = description.Length;
    parameter.Value = description;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlParameter-Klasse
SqlParameter-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server