SqlParameter.Size Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

Získá nebo nastaví maximální velikost dat v bajtech v rámci sloupce.

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

Hodnota vlastnosti

Int32

Maximální velikost dat ve sloupci (v bajtech). Výchozí hodnota je odvozena z hodnoty parametru.

Implementuje

Size
Atributy
DataSysDescriptionAttribute

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

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

Poznámky

Návratové hodnoty nejsou touto vlastností ovlivněny; návratové parametry z uložených procedur jsou vždy celá čísla s pevnou velikostí.

U výstupních parametrů s proměnlivým typem délky (například nvarchar) definuje velikost parametru velikost vyrovnávací paměti, která obsahuje výstupní parametr. Výstupní parametr lze zkrátit na velikost zadanou pomocí Size. U typů znaků je velikost zadaná parametrem Size ve znach.

Vlastnost se Size používá pro binární a řetězcové typy. U parametrů typu SqlType.Stringznamená Size délka znaků Unicode. Parametry typu SqlType.Xmlse Size ignorují.

U neřetězcových datových typů a řetězcových dat Size ANSI odkazuje vlastnost na počet bajtů. V případě řetězcových dat Size Unicode odkazuje na počet znaků. Počet řetězců neobsahuje ukončovací znak.

Pro datové typy s proměnlivou délkou popisuje maximální množství dat, Size které se mají přenést na server. Například pro řetězcovou hodnotu Size Unicode lze použít k omezení množství dat odeslaných na server na prvních sto znaků.

Pokud není explicitně nastavená, velikost se odvodí ze skutečné velikosti zadané hodnoty parametru.

Pokud je desetinná část hodnoty parametru větší než velikost, zkrátí se hodnota tak, aby odpovídala velikosti.

U datových typů s pevnou délkou se hodnota Size ignoruje. Dá se načíst pro informační účely a vrátí maximální množství bajtů, které zprostředkovatel používá při přenosu hodnoty parametru na server.

Informace o streamování najdete v tématu Podpora streamování SqlClient.

Platí pro

Viz také