SqlParameter.Size Eigenschaft

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 eine SqlParameter Reihe seiner Eigenschaften erstellt und 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 sind von dieser Eigenschaft nicht betroffen; Rückgabeparameter aus gespeicherten Prozeduren sind immer feste Ganze Zahlen.

Für Ausgabeparameter mit einem Variablenlängentyp (z. B. nvarchar), definiert die Größe des Parameters die Größe des Puffers, der den Ausgabeparameter hält. Der Ausgabeparameter kann auf eine größe abgeschnitten werden, die mit Size. Bei Zeichentypen ist die angegebene Size Größe in Zeichen enthalten.

Die Size Eigenschaft wird für binäre und Zeichenfolgentypen verwendet. Für Parameter des Typs bedeutet die Länge in Unicode-ZeichenSqlType.String``Size. Für Parameter des Typs SqlType.Xml``Size wird ignoriert.

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

Für Datentypen variabler Länge wird die maximale Datenmenge beschrieben, Size die an den Server übertragen werden soll. Beispielsweise könnte für einen Unicode-Zeichenfolgenwert die Menge an Daten, die an den Server gesendet werden, Size auf die ersten hundert Zeichen beschränkt werden.

Wenn die Größe nicht explizit festgelegt wird, 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 Size ignoriert. Sie kann für Informationszwecke abgerufen werden und gibt die maximale Menge von Bytes zurück, die der Anbieter beim Übertragen des Werts des Parameters an den Server verwendet.

Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

Gilt für