DbParameter.Size Propriété

  • Référence

Définition

Espace de noms:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Source:
DbParameter.cs
Source:
DbParameter.cs
Source:
DbParameter.cs

Obtient ou définit la taille maximale, en octets, des données dans la colonne.

public:
 abstract property int Size { int get(); void set(int value); };
public abstract int Size { get; set; }
member this.Size : int with get, set
Public MustOverride Property Size As Integer

Valeur de propriété

Int32

Taille maximale, en octets, des données dans la colonne. La valeur par défaut est déduite à partir de la valeur du paramètre.

Implémente

Size

Remarques

La Size propriété est utilisée pour les types binaires et chaînes.

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 peut être utilisé 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 explicitement défini, la valeur est déduite de la taille réelle du paramètre spécifié lorsqu’une instruction paramétrable est exécutée.

Les DbType propriétés et 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 DbParameter 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.

Pour les types de données de longueur fixe, la valeur de Size est ignorée. Il peut être récupéré à titre 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.

Si la taille de la valeur fournie pour un DbParameter dépasse la spécifiée Size, le Value de DbParameter contient la valeur spécifiée, tronquée à la taille du DbParameter.

Pour les paramètres de type DbType.String, la valeur de Size est longueur en caractères Unicode. Pour les paramètres de type DbType.Xml, Size est ignoré.

S’applique à

Voir aussi