OleDbParameter.Size Propiedad
Definición
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:
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, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerValor 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
- Atributos
Ejemplos
En el ejemplo siguiente se crea y OleDbParameter se establecen algunas de sus propiedades.
Public Sub CreateOleDbParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub 'CreateOleDbParameter
public void CreateOleDbParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);
parameter.Direction = ParameterDirection.Output;
parameter.Size = myValue.Length;
parameter.Value = myValue;
}
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 100 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 de se deduce del tamaño real del parámetro especificado cuando se ejecuta una instrucción parametrizada.
Las DbTypepropiedades , OleDbTypey Size de un parámetro se pueden deducir estableciendo Value. Por lo tanto, no es necesario especificarlos. Sin embargo, no se exponen en OleDbParameter la configuración de propiedades. Por ejemplo, si se ha inferido el tamaño del parámetro, Size no contiene el valor inferido después de la ejecución de la instrucción.
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.
Si el tamaño del valor proporcionado para un OleDbParameter supera el especificado Size, el Value de OleDbParameter contiene el valor especificado, truncado al tamaño de OleDbParameter.
