OleDbParameter.Size Propiedad

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v8.0.0

Source:

DbParameterHelper.cs

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

Consulte también

• Trabajar con comandos