DbParameter.Size Propiedad

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

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

Valor de propiedad

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

Implementaciones

Comentarios

La Size propiedad se usa para los tipos binarios y de cadena.

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.

Para los parámetros bidireccionales y de salida, y los valores devueltos, debe establecer el valor de Size. Esto no es necesario para los parámetros de entrada y, si no se establece explícitamente, el valor se deduce del tamaño real del parámetro especificado cuando se ejecuta una instrucción parametrizada.

Las DbType propiedades y Size de un parámetro se pueden deducir estableciendo Value. Por lo tanto, no es necesario especificarlos. Sin embargo, no se exponen en DbParameter la configuración de propiedades. Por ejemplo, si el tamaño del parámetro se ha inferido, Size no contiene un valor inferido después de la ejecución de la instrucción.

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.

Si el tamaño del valor proporcionado para un DbParameter supera el especificado Size, el Value de DbParameter contendrá el valor especificado, truncado al tamaño de DbParameter.

Para los parámetros de tipo DbType.String, el valor de Size es length en caracteres Unicode. En el caso de los parámetros de tipo DbType.Xml, Size se omite.

Se aplica a

Consulte también

• Información general de ADO.NET