DbParameter.Size Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic MustOverride Property Size As IntegerWartość 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ągów ANSI właściwość odnosi 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 opisano 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 ustawiona, wartość jest wnioskowana z rzeczywistego rozmiaru określonego parametru, gdy jest wykonywana instrukcja sparametryzowana.
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ć. Nie są one jednak 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 parametru przekracza określoną Sizewartość , właściwość ValueDbParameter będzie zawierać określoną wartość, obcięta do rozmiaru 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.
