OleDbParameter.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 kolumnie w bajtach.
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, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerWartość właściwości
Maksymalny rozmiar (w bajtach) danych w kolumnie. Wartość domyślna jest wnioskowana z wartości parametru.
Implementuje
- Atrybuty
Przykłady
Poniższy przykład tworzy obiekt OleDbParameter i ustawia niektóre z jego właściwości.
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;
}
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ść 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 w przypadku wartości Size ciągu Unicode można użyć do ograniczenia ilości danych wysyłanych do serwera do pierwszych 100 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 podczas wykonywania sparametryzowanej instrukcji.
Właściwości DbType, OleDbTypei 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 OleDbParameter 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 długości wartość Size 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 obiektu OleDbParameter przekracza określoną Sizewartość , parametr OleDbParameterValue zawiera określoną wartość, obcięty do rozmiaru OleDbParameterobiektu .
