SqlParameter.Size Propiedad
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Tamaño máximo, en bytes, de los datos de la columna. El valor predeterminado se deduce del valor del parámetro.
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;
}
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.