OdbcParameter.Size Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la taille maximale des données figurant dans la colonne.
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
Valeur de propriété
Taille maximale des données figurant dans la colonne. La valeur par défaut est déduite à partir de la valeur du paramètre.
Implémente
Exemples
L’exemple suivant crée un OdbcParameter et définit certaines de ses propriétés.
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;
}
Remarques
La Size propriété est utilisée pour les types binaire et chaîne.
Pour les types de données non chaînes et les données de chaîne ANSI, la Size propriété fait référence au nombre d’octets. Pour les données de chaîne Unicode, Size fait référence au nombre de caractères. Le nombre de chaînes n’inclut pas le caractère de fin.
Pour les types de données de longueur variable, Size
décrit la quantité maximale de données à transmettre au serveur. Par exemple, pour une valeur de chaîne Unicode, Size
vous pouvez utiliser pour limiter la quantité de données envoyées au serveur aux cent premiers caractères.
Pour les paramètres bidirectionnels et de sortie, et les valeurs de retour, vous devez définir la valeur de Size
. Cela n’est pas obligatoire pour les paramètres d’entrée et, s’il n’est pas défini explicitement, la valeur de est déduite de la taille réelle du paramètre spécifié lors de l’exécution d’une instruction paramétrable.
Les DbTypepropriétés , OdbcTypeet Size d’un paramètre peuvent être déduites en définissant Value. Par conséquent, vous n’êtes pas obligé de les spécifier. Toutefois, ils ne sont pas exposés dans OdbcParameter les paramètres de propriété. Par exemple, si la taille du paramètre a été déduite, Size
ne contient pas de valeur déduite après l’exécution de l’instruction.
Notes
Pour un OdbcParameter
avec un Direction de ParameterDirection.Output
, ParameterDirection.InputOutput
ou ParameterDirection.ReturnValue
, une exception est levée lorsque la commande est exécutée si la taille de la valeur retournée par la source de données dépasse la valeur spécifiée Size
de .OdbcParameter
Pour les types de données de longueur fixe, la valeur de Size
est ignorée. Il peut être récupéré à des fins d’information et retourne la quantité maximale d’octets que le fournisseur utilise lors de la transmission de la valeur du paramètre au serveur.