SqlParameter.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, en octets, des données de 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; }[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }member this.Size : int with get, set[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerValeur de propriété
Taille maximale, en octets, des données de la colonne. La valeur par défaut est déduite de la valeur du paramètre.
Implémente
- Attributs
Exemples
L’exemple suivant crée une SqlParameter valeur et définit certaines de ses propriétés.
static void CreateSqlParameterSize()
{
string description = "12 foot scarf - multiple colors, one previous owner";
SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
parameter.Direction = ParameterDirection.InputOutput;
parameter.Size = description.Length;
parameter.Value = description;
}
Private Sub CreateSqlParameterSize()
Dim description As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
parameter.Direction = ParameterDirection.InputOutput
parameter.Size = description.Length
parameter.Value = description
End Sub
Remarques
Les valeurs de retour ne sont pas affectées par cette propriété ; les paramètres de retour des procédures stockées sont toujours des entiers de taille fixe.
Pour les paramètres de sortie avec un type de longueur variable (nvarchar, par exemple), la taille du paramètre définit la taille de la mémoire tampon contenant le paramètre de sortie. Le paramètre de sortie peut être tronqué à une taille spécifiée avec Size. Pour les types de caractères, la taille spécifiée Size est en caractères.
La Size propriété est utilisée pour les types binaires et de chaînes. Pour les paramètres de type SqlType.String, Size signifie la longueur dans les caractères Unicode. Pour les paramètres de type SqlType.Xml, Size est ignoré.
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ée pour limiter la quantité de données envoyées au serveur aux cent premiers caractères.
Si elle n’est pas définie explicitement, la taille est déduite de la taille réelle de la valeur de paramètre spécifiée.
Si la partie fractionnaire de la valeur du paramètre est supérieure à la taille, la valeur est tronquée pour correspondre à la taille.
Pour les types de données de longueur fixe, la valeur de celle-ci 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.
Pour plus d’informations sur la diffusion en continu, consultez La prise en charge de la diffusion en continu SqlClient.
