Condividi tramite

SqlParameter.Size Proprietà

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Origine:
System.Data.SqlClient.notsupported.cs

Ottiene o imposta le dimensioni massime, in byte, dei dati all'interno della colonna.

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

Valore della proprietà

Int32

Dimensione massima, in byte, dei dati all'interno della colonna. Il valore predefinito viene dedotto dal valore del parametro.

Implementazioni

Size
Attributi
DataSysDescriptionAttribute

Esempio

Nell'esempio seguente viene creato un SqlParameter oggetto e vengono impostate alcune delle relative proprietà.

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

Commenti

I valori restituiti non sono interessati da questa proprietà; i parametri restituiti dalle stored procedure sono sempre numeri interi a dimensione fissa.

Per i parametri di output con un tipo di lunghezza variabile (ad esempio, nvarchar), la dimensione del parametro definisce le dimensioni del buffer che contiene il parametro di output. Il parametro di output può essere troncato a una dimensione specificata con Size. Per i tipi di caratteri, le dimensioni specificate con Size sono in caratteri.

La Size proprietà viene utilizzata per i tipi binari e stringa. Per i parametri di tipo SqlType.String, Size indica la lunghezza nei caratteri Unicode. Per i parametri di tipo SqlType.Xml, Size viene ignorato.

Per i tipi di dati nonstring e i dati stringa ANSI, la Size proprietà fa riferimento al numero di byte. Per i dati stringa Unicode, Size fa riferimento al numero di caratteri. Il conteggio per le stringhe non include il carattere di terminazione.

Per i tipi di dati a lunghezza variabile, Size descrive la quantità massima di dati da trasmettere al server. Ad esempio, per un valore stringa Unicode, Size può essere usato per limitare la quantità di dati inviati al server ai primi cento caratteri.

Se non è impostata in modo esplicito, la dimensione viene dedotta dalle dimensioni effettive del valore del parametro specificato.

Se la parte frazionaria del valore del parametro è maggiore della dimensione, il valore verrà troncato in modo che corrisponda alle dimensioni.

Per i tipi di dati a lunghezza fissa, il valore di Size viene ignorato. Può essere recuperato a scopo informativo e restituisce la quantità massima di byte utilizzata dal provider durante la trasmissione del valore del parametro al server.

Per informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.

Si applica a

Vedi anche