Freigeben über


SqlParameter.Size Eigenschaft

Definition

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

public:
 virtual property int Size { int get(); void set(int value); };
public override int Size { get; set; }
member this.Size : int with get, set
Public Overrides Property Size As Integer

Eigenschaftswert

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

Implementiert

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Rückgabewerte werden von dieser Eigenschaft nicht beeinflusst. Rückgabeparameter aus gespeicherten Prozeduren sind immer ganze Zahlen mit fester Größe.

Bei Ausgabeparametern mit einem Variablenlängentyp (z. B. nvarchar) definiert die Größe des Parameters die Größe des Puffers, der den Ausgabeparameter enthält. Der Ausgabeparameter kann auf eine Größe gekürzt werden, die mit Sizeangegeben wird. Bei Zeichentypen ist die angegebene Größe in Size Zeichen angegeben.

Die Size -Eigenschaft wird für Binär- und Zeichenfolgentypen verwendet. Für Parameter vom Typ SqlType.Stringbedeutet länge Size in Unicode-Zeichen. Bei Parametern vom Typ SqlType.XmlSize wird ignoriert.

Für nicht zeichenfolgenfreie Datentypen und ANSI-Zeichenfolgendaten bezieht sich die Size -Eigenschaft auf die Anzahl der Bytes. Bei Unicode-Zeichenfolgendaten Size bezieht sich auf die Anzahl der Zeichen. Die Anzahl für Zeichenfolgen enthält nicht das beendende Zeichen.

Beschreibt bei Datentypen mit variabler Länge die maximale Datenmenge, Size die an den Server übertragen werden soll. Beispielsweise kann für einen Unicode-Zeichenfolgenwert verwendet werden, Size um die Menge der an den Server gesendeten Daten auf die ersten hundert Zeichen zu beschränken.

Wenn sie nicht explizit festgelegt ist, wird die Größe aus der tatsächlichen Größe des angegebenen Parameterwerts abgeleitet.

Wenn der Bruchteil des Parameterwerts größer als die Größe ist, wird der Wert abgeschnitten, um der Größe zu entsprechen.

Bei Datentypen mit fester Länge wird der Wert von Size ignoriert. Er kann zu Informationszwecken abgerufen werden und gibt die maximale Bytesmenge zurück, die der Anbieter beim Übertragen des Werts des Parameters an den Server verwendet.

Informationen zum Streaming finden Sie unter SqlClient-Streamingunterstützung.

Gilt für: