DbParameter.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 ve sloupci v bajtech.
public:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride Property Size As IntegerHodnota vlastnosti
Maximální velikost dat ve sloupci (v bajtech). Výchozí hodnota je odvozena z hodnoty parametru.
Implementuje
Poznámky
Vlastnost se Size používá pro binární a řetězcové typy.
U neřetězcových datových typů 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ů.
U obousměrných a výstupních parametrů a návratových hodnot je nutné nastavit hodnotu Size. To není vyžadováno pro vstupní parametry, a pokud není explicitně nastaven, hodnota je odvozena ze skutečné velikosti zadaného parametru při spuštění parametrizovaného příkazu.
Vlastnosti DbType a Size parametru lze odvodit nastavením Value. Proto je nemusíte zadávat. Nejsou však vystaveny v DbParameter nastavení vlastností. Například pokud byla odvozena velikost parametru, Size neobsahuje odvozenou hodnotu po spuštění příkazu.
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.
Pokud velikost zadané hodnoty překročí zadanou DbParameterSizehodnotu , DbParameterValue bude hodnota obsahovat zadanou hodnotu zkrácenou na Velikost objektu DbParameter.
U parametrů typu DbType.String, hodnota Size je délka ve znaky Unicode. U parametrů typu DbType.Xml, Size se ignoruje.
