SqlParameter.Size Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá nebo nastaví maximální velikost dat ve sloupci v bajtech.

public:
 virtual property int Size { int get(); void set(int value); };

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides 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

Příklady

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

// using Microsoft.Data.SqlClient;
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;
}

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ěnný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í Sizepříkazu . U typů znaků je velikost zadaná Size pomocí znaků ve znaménách.

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

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

U datových typů 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á, je velikost odvozena ze skutečné velikosti zadané hodnoty parametru.

Pokud je zlomková část hodnoty parametru větší než velikost, bude hodnota zkrácena 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.