SqlParameter.Size Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece el tamaño máximo, en bytes, de los datos de la columna.

public:
 virtual property int Size { int get(); void set(int value); };

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

Valor de propiedad

Int32

Tamaño máximo, en bytes, de los datos de la columna. El valor predeterminado se deduce del valor del parámetro.

Implementaciones

Size

Ejemplos

En el ejemplo siguiente se crea y SqlParameter se establecen algunas de sus propiedades.

// using Microsoft.Data.SqlClient;
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;
}

Comentarios

Los valores devueltos no se ven afectados por esta propiedad; los parámetros return de los procedimientos almacenados siempre son enteros de tamaño fijo.

Para los parámetros de salida con un tipo de longitud variable (nvarchar, por ejemplo), el tamaño del parámetro define el tamaño del búfer que contiene el parámetro de salida. El parámetro de salida se puede truncar a un tamaño especificado con Size. Para los tipos de caracteres, el tamaño especificado con Size está en caracteres.

La Size propiedad se usa para los tipos binarios y de cadena. Para los parámetros de tipo SqlType.String, Size significa longitud en caracteres Unicode. En el caso de los parámetros de tipo SqlType.Xml, Size se omite.

Para los tipos de datos que no son cadenas y los datos de cadena ANSI, la Size propiedad hace referencia al número de bytes. Para los datos de cadena Unicode, Size hace referencia al número de caracteres. El recuento de cadenas no incluye el carácter de terminación.

En el caso de los tipos de datos de longitud variable, Size se describe la cantidad máxima de datos que se van a transmitir al servidor. Por ejemplo, para un valor de cadena Unicode, Size se podría usar para limitar la cantidad de datos enviados al servidor a los primeros cien caracteres.

Si no se establece explícitamente, el tamaño se deduce del tamaño real del valor de parámetro especificado.

Si la parte fraccionarcional del valor del parámetro es mayor que el tamaño, el valor se truncará para que coincida con el tamaño.

En el caso de los tipos de datos de longitud fija, se omite el valor de Size . Se puede recuperar con fines informativos y devuelve la cantidad máxima de bytes que usa el proveedor al transmitir el valor del parámetro al servidor.

Para obtener información sobre el streaming, consulte Compatibilidad con el streaming de SqlClient.