OdbcParameter.Size Właściwość

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

System.Data.Odbc v8.0.0

Źródło:

OdbcParameterHelper.cs

Pobiera lub ustawia maksymalny rozmiar danych w kolumnie.

public:
 virtual property int Size { int get(); void set(int value); };

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

Wartość właściwości

Int32

Maksymalny rozmiar danych w kolumnie. Wartość domyślna jest wnioskowana z wartości parametru.

Implementuje

Size

Przykłady

Poniższy przykład tworzy element OdbcParameter i ustawia niektóre jego właściwości.

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;  
 }  

Uwagi

Właściwość Size jest używana dla typów binarnych i ciągów.

W przypadku typów danych nieciągujących i danych Size ciągu ANSI właściwość odwołuje się do liczby bajtów. W przypadku danych Size ciągów Unicode odnosi się do liczby znaków. Liczba ciągów nie zawiera znaku zakończenia.

W przypadku typów Size danych o zmiennej długości opisuje maksymalną ilość danych do przesłania na serwer. Na przykład dla wartości Size ciągu Unicode można użyć do ograniczenia ilości danych wysyłanych do serwera do pierwszych setek znaków.

W przypadku parametrów dwukierunkowych i wyjściowych oraz zwracanych wartości należy ustawić wartość Size. Nie jest to wymagane dla parametrów wejściowych, a jeśli nie jest jawnie ustawione, wartość jest wnioskowana z rzeczywistego rozmiaru określonego parametru po wykonaniu instrukcji sparametryzowanej.

Właściwości DbTypeparametru , OdbcTypei Size można wywnioskować, ustawiając Valuewartość . W związku z tym nie trzeba ich określać. Jednak nie są one widoczne w OdbcParameter ustawieniach właściwości. Jeśli na przykład rozmiar parametru został wywnioskowany, Size nie zawiera wywnioskowanej wartości po wykonaniu instrukcji.

Uwaga

W przypadku elementu OdbcParameter z wartością DirectionParameterDirection.Output, ParameterDirection.InputOutputlub ParameterDirection.ReturnValuewyjątek jest zgłaszany, gdy polecenie jest wykonywane, jeśli rozmiar wartości zwróconej przez źródło danych przekracza określony SizeOdbcParameterparametr .

W przypadku typów danych o stałej Size długości wartość jest ignorowana. Można go pobrać do celów informacyjnych i zwraca maksymalną ilość bajtów używanych przez dostawcę podczas przesyłania wartości parametru do serwera.

Zobacz też

• Praca z poleceniami