DbParameter.Size Własność
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
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ść nieruchomoś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.
