Partager via

OleDbParameter.Size Propriété

Définition

Espace de noms:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Paquet:
System.Data.OleDb v11.0.0-preview.2.26159.112
Source:
DbParameterHelper.cs
Source:
DbParameterHelper.cs
Source:
DbParameterHelper.cs
Source:
DbParameterHelper.cs

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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

Valeur de propriété

Int32

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

Size
Attributs
DataSysDescriptionAttribute

Exemples

L’exemple suivant crée une OleDbParameter et définit certaines de ses propriétés.

Public Sub CreateOleDbParameter()
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = myValue.Length
    parameter.Value = myValue
End Sub 'CreateOleDbParameter

public void CreateOleDbParameter()
 {
    string myValue = "12 foot scarf - multiple colors, one previous owner";
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = myValue.Length;
    parameter.Value = myValue;
 }

Remarques

La Size propriété est utilisée pour les types binaires et de 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ée pour limiter la quantité de données envoyées au serveur aux 100 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 celle-ci est déduite de la taille réelle du paramètre spécifié lorsqu’une instruction paramétrable est exécutée.

Les DbTypepropriétés et Size les OleDbTypepropriétés 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, elles ne sont pas exposées dans OleDbParameter les paramètres de propriété. Par exemple, si la taille du paramètre a été déduite, Size ne contient pas la valeur déduite après l’exécution de l’instruction.

Pour les types de données de longueur fixe, la valeur est Size 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.

Si la taille de la valeur fournie pour un OleDbParameter dépassement de la valeur spécifiéeSize, celle-ci OleDbParameterValue contient la valeur spécifiée, tronquée à la taille du OleDbParameter.

S’applique à

Voir aussi