OdbcParameter.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.
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; }public int Size { get; set; }member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerHodnota vlastnosti
Maximální velikost dat ve sloupci Výchozí hodnota je odvozena z hodnoty parametru.
Implementuje
Příklady
Následující příklad vytvoří OdbcParameter a nastaví některé jeho vlastnosti.
Public Sub CreateOdbcParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OdbcParameter parameter = new OdbcParameter("Description", OdbcType.VarChar);
parameter.Direction = ParameterDirection.Output;
parameter.Size = myValue.Length;
parameter.Value = myValue;
}
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ů. 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ů.
Pro obousměrné a výstupní parametry a návratové hodnoty musíte nastavit hodnotu Size. To není vyžadováno pro vstupní parametry, a pokud není explicitně nastavena, hodnota je odvozena ze skutečné velikosti zadaného parametru při spuštění parametrizovaného příkazu.
Vlastnosti DbType, OdbcTypea Size parametru lze odvodit nastavením Value. Proto je nemusíte zadávat. Nejsou však zpřístupněny v OdbcParameter nastavení vlastností. Pokud byla například odvozena velikost parametru , Size neobsahuje odvozenou hodnotu po spuštění příkazu.
Poznámka
Pro objekt OdbcParameter s DirectionParameterDirection.Outputhodnotou , ParameterDirection.InputOutputnebo ParameterDirection.ReturnValuese při spuštění příkazu vyvolá výjimka, pokud velikost hodnoty vrácené zdrojem dat překročí zadanou Size hodnotu OdbcParameter.
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.
