Sdílet prostřednictvím

OleDbParameter.Size Vlastnost

Definice

Obor názvů:
System.Data.OleDb
Sestavení:
System.Data.OleDb.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.OleDb v11.0.0-preview.2.26159.112
Zdroj:
DbParameterHelper.cs
Zdroj:
DbParameterHelper.cs
Zdroj:
DbParameterHelper.cs
Zdroj:
DbParameterHelper.cs

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

Int32

Maximální velikost dat ve sloupci v bajtech. Výchozí hodnota je odvozena z hodnoty parametru.

Implementuje

Size
Atributy
DataSysDescriptionAttribute

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 Size se používá pro binární a řetězcové typy.

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 řetězcovou hodnotu Size Unicode lze použít k omezení množství dat odesílaných na server na prvních 100 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ě nastavena, hodnota je odvozena ze skutečné velikosti zadaného parametru při spuštění parametrizovaného příkazu.

Parametr DbType, OleDbTypea Size vlastnosti lze odvodit nastavením Value. Proto je nemusíte zadávat. V nastavení vlastností se ale nezpřístupní OleDbParameter . 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é poskytovatel používá při přenosu hodnoty parametru na server.

Pokud velikost zadané hodnoty překročí zadanou Sizehodnotu , ValueOleDbParameter obsahuje zadanou hodnotu zkrácenou na velikost OleDbParameter.OleDbParameter

Platí pro

Viz také