SqlParameter.Size Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerHodnota vlastnosti
Maximální velikost dat ve sloupci v bajtech. Výchozí hodnota je odvozena z hodnoty parametru.
Implementuje
- Atributy
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
Tato vlastnost nemá vliv na návratové hodnoty; návratové parametry z uložených procedur jsou vždy celá čísla s pevnou velikostí.
Pro výstupní parametry s proměnným typem délky (například nvarchar), velikost parametru definuje velikost vyrovnávací paměti, která obsahuje výstupní parametr. Výstupní parametr lze zkrátit na velikost určenou parametrem Size. U typů znaků je velikost zadaná Size se znaky.
Vlastnost Size se používá pro binární a řetězcové typy. Pro parametry typu SqlType.Stringznamená Size délku znaků Unicode. U parametrů typu SqlType.XmlSize se ignoruje.
Pro neřetězné datové typy a data Size řetězce ANSI odkazuje vlastnost na počet bajtů. U řetězcových dat Size Unicode odkazuje na počet znaků. Počet řetězců neobsahuje ukončovací znak.
U datových typů Size s proměnlivou délkou popisuje maximální množství dat, která se mají přenést na server. Například pro hodnotu Size řetězce Unicode lze použít k omezení množství dat odesílaný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é poskytovatel používá při přenosu hodnoty parametru na server.
Informace o streamování najdete v tématu Podpora streamování SqlClient.
