Sdílet prostřednictvím


OleDbParameter.Size Vlastnost

Definice

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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

Hodnota 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ří OleDbParameter a nastaví některé jeho vlastnosti.

Public Sub CreateOleDbParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub 'CreateOleDbParameter  
public void CreateOleDbParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.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 odesílaných na server na prvních 100 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, OleDbTypea Size parametru lze odvodit nastavením Value. Proto je nemusíte zadávat. Nejsou však zpřístupněny v OleDbParameter nastavení vlastností. Pokud byla například odvozena velikost parametru, Size neobsahuje odvozenou hodnotu po provedení 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 OleDbParameterSizehodnotu , OleDbParameterValue obsahuje hodnota z objektu zadanou hodnotu zkrácenou na velikost OleDbParameter.

Platí pro

Viz také