DbParameter.Size Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.Common
Sestavení:
System.Data.Common.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll
Zdroj:
DbParameter.cs
Zdroj:
DbParameter.cs
Zdroj:
DbParameter.cs

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, set
Public MustOverride 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

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.

Platí pro

Viz také