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, set
Public Overrides Property Size As Integer
Public Property Size As Integer
Valor 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 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 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 un valor inferido después de la ejecución de la instrucción.
Nota
OdbcParameter
Para con un Direction valor de ParameterDirection.Output
, ParameterDirection.InputOutput
o ParameterDirection.ReturnValue
, 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.
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.