SqlParameter.Size Eigenschaft

Definition

Dient zum Abrufen oder Festlegen der maximalen Größe (in Bytes) der Daten in der Spalte.Gets or sets the maximum size, in bytes, of the data within the column.

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
Public Overrides Property Size As Integer
Public Property Size As Integer

Eigenschaftswert

Die maximale Größe (in Bytes) der Daten in der Spalte.The maximum size, in bytes, of the data within the column. Der Standardwert wird aus dem Parameterwert hergeleitet.The default value is inferred from the parameter value.

Implementiert

Attribute

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.The following example creates a SqlParameter and sets some of its properties.

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ückgabe Parameter aus gespeicherten Prozeduren sind immer ganze Zahlen mit fester Größe.Return values are not affected by this property; return parameters from stored procedures are always fixed-size integers.

Für Ausgabeparameter mit einem Typ variabler Länge (z. b. nvarchar) definiert die Größe des-Parameters die Größe des Puffers, der den Output-Parameter enthält.For output parameters with a variable length type (nvarchar, for example), the size of the parameter defines the size of the buffer holding the output parameter. Der Output-Parameter kann auf eine mit Sizeangegebene Größe gekürzt werden.The output parameter can be truncated to a size specified with Size. Bei Zeichen Typen wird die mit Size angegebene Größe in Zeichen angegeben.For character types, the size specified with Size is in characters.

Die Size-Eigenschaft wird für Binär-und Zeichen folgen Typen verwendet.The Size property is used for binary and string types. Für Parameter vom Typ SqlType.Stringbedeutet Size Länge in Unicode-Zeichen.For parameters of type SqlType.String, Size means length in Unicode characters. Für Parameter vom Typ SqlType.Xmlwird Size ignoriert.For parameters of type SqlType.Xml, Size is ignored.

Bei nicht-Zeichen folgen-Datentypen und ANSI-Zeichen folgen Daten bezieht sich die Size-Eigenschaft auf die Anzahl der Bytes.For nonstring data types and ANSI string data, the Size property refers to the number of bytes. Bei Unicode-Zeichen folgen Daten bezieht sich Size auf die Anzahl der Zeichen.For Unicode string data, Size refers to the number of characters. Der Zähler für Zeichen folgen enthält das abschließende Zeichen nicht.The count for strings does not include the terminating character.

Bei Datentypen mit variabler Länge werden Size die maximale Datenmenge beschrieben, die an den Server übermittelt werden soll.For variable-length data types, Size describes the maximum amount of data to transmit to the server. Für einen Unicode-Zeichen folgen Wert können Size z. b. verwendet werden, um die an den Server gesendete Datenmenge auf die ersten 100 Zeichen einzuschränken.For example, for a Unicode string value, Size could be used to limit the amount of data sent to the server to the first one hundred characters.

Wenn nicht explizit festgelegt, wird die Größe von der tatsächlichen Größe des angegebenen Parameter Werts abgeleitet.If not explicitly set, the size is inferred from the actual size of the specified parameter value.

Wenn der Bruch Teil des Parameter Werts größer ist als die Größe, wird der Wert abgeschnitten, damit er mit der Größe identisch ist.If the fractional part of the parameter value is greater than the size, then the value will be truncated to match the size.

Bei Datentypen mit fester Länge wird der Wert von Size ignoriert.For fixed length data types, the value of Size is ignored. Sie kann zu Informationszwecken abgerufen werden und gibt die maximale Anzahl von Bytes zurück, die der Anbieter verwendet, wenn der Wert des-Parameters an den Server übertragen wird.It can be retrieved for informational purposes, and returns the maximum amount of bytes the provider uses when transmitting the value of the parameter to the server.

Weitere Informationen zum Streaming finden Sie unter SqlClient-Streamingunterstützung.For information about streaming, see SqlClient Streaming Support.

Gilt für:

Siehe auch