OdbcParameter.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 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; }public int Size { get; set; }member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerValor de propiedad
Tamaño máximo de los datos de la columna. El valor predeterminado se deduce del valor del parámetro.
Implementaciones
Ejemplos
En el ejemplo siguiente se crea y OdbcParameter se establecen algunas de sus propiedades.
Public Sub CreateOdbcParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OdbcParameter parameter = new OdbcParameter("Description", OdbcType.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 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.
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 , OdbcTypey Size de un parámetro se pueden deducir estableciendo Value. Por lo tanto, no es necesario especificarlos. Sin embargo, no se exponen en OdbcParameter la configuración de propiedades. Por ejemplo, si el tamaño del parámetro se ha inferido, Size no contiene valor inferido después de la ejecución de la instrucción.
Nota
Para con OdbcParameter un de , o , se produce una excepción cuando se ejecuta el comando si el tamaño del valor devuelto por el origen de datos supera el especificado Size de OdbcParameter.ParameterDirection.ReturnValue``ParameterDirection.InputOutput``ParameterDirection.OutputDirection
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.