SqlParameter.Size Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Pakiet:
System.Data.SqlClient v4.8.6

Pobiera lub ustawia maksymalny rozmiar danych w bajtach w kolumnie.

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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

Wartość właściwości

Int32

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

Implementuje

Size
Atrybuty
DataSysDescriptionAttribute

Przykłady

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

static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.InputOutput;
    parameter.Size = description.Length;
    parameter.Value = description;
}

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

Uwagi

Wartości zwracane nie mają wpływu na tę właściwość; parametry zwracane z procedur składowanych są zawsze liczbą całkowitą o stałym rozmiarze.

W przypadku parametrów wyjściowych o typie zmiennej długości (na przykład nvarchar) rozmiar parametru definiuje rozmiar buforu trzymającego parametr wyjściowy. Parametr wyjściowy można obcinać do rozmiaru określonego za pomocą Sizepolecenia . W przypadku typów znaków rozmiar określony za pomocą Size znaków ma znaki.

Właściwość Size jest używana dla typów binarnych i ciągów. W przypadku parametrów typu SqlType.StringSize , oznacza długość znaków Unicode. W przypadku parametrów typu SqlType.Xml, Size jest ignorowany.

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.

Jeśli nie zostanie jawnie ustawiony, rozmiar zostanie wywnioskowany z rzeczywistego rozmiaru określonej wartości parametru.

Jeśli część ułamkowa wartości parametru jest większa niż rozmiar, wartość zostanie obcięta w celu dopasowania do rozmiaru.

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.

Aby uzyskać informacje na temat przesyłania strumieniowego, zobacz SqlClient Streaming Support (Obsługa przesyłania strumieniowego sqlClient).

Dotyczy

Zobacz też