Udostępnij za pośrednictwem


DbParameter.Size Właściwość

Definicja

Pobiera lub ustawia maksymalny rozmiar danych w bajtach w kolumnie.

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

Wartość właściwości

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

Implementuje

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 w przypadku parametrów wejściowych, a jeśli nie zostanie jawnie ustawiona, wartość jest wnioskowana z rzeczywistego rozmiaru określonego parametru po wykonaniu instrukcji sparametryzowanej.

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

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.

Jeśli rozmiar wartości podanej dla DbParameter wartości Sizeprzekracza określoną wartość , ValueDbParameter element będzie zawierać określoną wartość, obcięty z rozmiarem DbParameterelementu .

W przypadku parametrów typu DbType.String, wartość Size ma długość w znakach Unicode. W przypadku parametrów typu DbType.Xml, Size jest ignorowany.

Dotyczy

Zobacz też