SqlParameter.Size Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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:
 property int Size { int get(); void set(int value); };
public override int Size { get; set; }
[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }
member this.Size : int with get, set
[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

Eigenschaftswert

Int32

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

Implementiert

Size
Attribute
DataSysDescriptionAttribute

Beispiele

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

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

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.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

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.

Bei nicht zeichenfolgenfreien 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.

Für Datentypen mit variabler Länge beschreibt 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 Übermitteln des Werts des Parameters an den Server verwendet.

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

Gilt für:

Weitere Informationen