Compartir vía

SqlParameter.Size Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.SqlClient.dll
Ensamblado:
System.Data.dll
Ensamblados:
netstandard.dll, System.Data.SqlClient.dll
Paquete:
System.Data.SqlClient v4.8.6

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:
 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

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
Atributos
DataSysDescriptionAttribute

Ejemplos

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

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

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 en 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 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.

Para los tipos de datos de longitud variable, Size 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.

Para 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 streaming de SqlClient.

Se aplica a

Consulte también