SqlParameter.Size Eigenschaft
Definition
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 innerhalb der Spalte in Bytes ab oder legt sie 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, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerEigenschaftswert
Die maximale Größe der Daten in Bytes innerhalb der Spalte. Der Standardwert wird vom Parameterwert abgeleitet.
Implementiert
- Attribute
Beispiele
Im folgenden Beispiel wird ein SqlParameter Teil 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 ganze Zahlen mit fester Größe.
Bei Ausgabeparametern mit einem variablen Lä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 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. Bei Parametern vom Typ SqlType.StringSize bedeutet die Länge in Unicode-Zeichen. Bei Parametern vom Typ SqlType.XmlSize wird ignoriert.
Bei Nichtzeichenfolgendaten 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 Endzeichen.
Bei Datentypen mit variabler Länge wird die maximale Datenmenge beschrieben, Size die an den Server übertragen werden soll. Beispielsweise könnte für einen Unicode-Zeichenfolgenwert Size die Menge der an den Server gesendeten Daten auf die ersten hundert Zeichen beschränkt werden.
Wenn sie nicht explizit festgelegt wird, wird die Größe von 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 zu Informationszwecken abgerufen werden und gibt die maximale Anzahl 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.
