OleDbParameterCollection Classe

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

System.Data.OleDb v8.0.0

Source:

OleDbParameterCollection.cs

Représente une collection de paramètres en rapport avec un OleDbCommand, ainsi que leurs mappages respectifs aux colonnes d’un DataSet.

public ref class OleDbParameterCollection sealed : System::Data::Common::DbParameterCollection

public sealed class OleDbParameterCollection : System.Data.Common.DbParameterCollection

type OleDbParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class OleDbParameterCollection
Inherits DbParameterCollection

Héritage

Object

DbParameterCollection

OleDbParameterCollection

Exemples

L’exemple suivant crée plusieurs instances de OleDbParameter via la OleDbParameterCollection collection dans le OleDbDataAdapter. Ces paramètres sont utilisés pour sélectionner des données dans la source de données et placer les données dans .DataSet Cet exemple suppose qu’un DataSet et un OleDbDataAdapter ont déjà été créés avec le schéma, les commandes et la connexion appropriés.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Remarques

Le nombre de paramètres dans la collection doit être égal au nombre d’espaces réservés de paramètres dans le texte de la commande. Sinon, le fournisseur de données .NET Framework pour OLE DB peut générer une erreur.

Propriétés

Count	Retourne un entier qui contient le nombre d'éléments présents dans OleDbParameterCollection. Lecture seule.
IsFixedSize	Obtient une valeur qui indique si OleDbParameterCollection est de taille fixe. Lecture seule.
IsReadOnly	Obtient une valeur qui indique si l’objet OleDbParameterCollection est en lecture seule.
IsSynchronized	Obtient une valeur qui indique si l’objet OleDbParameterCollection est synchronisé. Lecture seule.
Item[Int32]	Obtient ou définit le OleDbParameter à l'index spécifié.
Item[String]	Obtient ou définit OleDbParameter portant le nom spécifié.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à OleDbParameterCollection. Lecture seule.

Méthodes

Add(Object)	Ajoute l'objet OleDbParameter spécifié au OleDbParameterCollection.
Add(OleDbParameter)	Ajoute le OleDbParameter spécifié à OleDbParameterCollection.
Add(String, Object)	Obsolète. Ajoute OleDbParameter à OleDbParameterCollection en fonction de la valeur et du nom du paramètre.
Add(String, OleDbType)	Ajoute OleDbParameter à OleDbParameterCollection en fonction du nom du paramètre et du type de données.
Add(String, OleDbType, Int32)	Ajoute OleDbParameter à OleDbParameterCollection en fonction du nom du paramètre, du type de données et de la longueur de colonne.
Add(String, OleDbType, Int32, String)	Ajoute OleDbParameter à OleDbParameterCollection en fonction du nom du paramètre, du type de données, de la longueur de colonne et du nom de colonne source.
AddRange(Array)	Ajoute un tableau de valeurs à la fin de l'objet OleDbParameterCollection.
AddRange(OleDbParameter[])	Ajoute un tableau de valeurs OleDbParameter à la fin de l'objet OleDbParameterCollection.
AddWithValue(String, Object)	Ajoute une valeur à la fin de l'objet OleDbParameterCollection.
Clear()	Supprime tous les objets OleDbParameter de OleDbParameterCollection.
Contains(Object)	Détermine si l'objet Object spécifié se trouve dans cet objet OleDbParameterCollection.
Contains(OleDbParameter)	Détermine si l'objet OleDbParameter spécifié se trouve dans cet objet OleDbParameterCollection.
Contains(String)	Détermine si l'objet String spécifié se trouve dans cet objet OleDbParameterCollection.
CopyTo(Array, Int32)	Copie tous les éléments de l'objet OleDbParameterCollection actuel dans le Array unidimensionnel spécifié, à partir de l'index Array de destination spécifié.
CopyTo(OleDbParameter[], Int32)	Copie tous les éléments de l'objet OleDbParameterCollection actuel dans l'objet OleDbParameterCollection spécifié à partir de l'index de destination donné.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un énumérateur qui itère au sein de OleDbParameterCollection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetParameter(Int32)	Retourne l’objet DbParameter à l’index spécifié dans la collection. (Hérité de DbParameterCollection)
GetParameter(String)	Retourne l’objet DbParameter avec le nom spécifié. (Hérité de DbParameterCollection)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(Object)	Emplacement du Object spécifié dans la collection.
IndexOf(OleDbParameter)	Obtient l'emplacement du OleDbParameter spécifié dans la collection.
IndexOf(String)	Obtient l'emplacement de l'objet OleDbParameter spécifié portant le nom donné.
Insert(Int32, Object)	Insère un élément Object dans OleDbParameterCollection à l'index spécifié.
Insert(Int32, OleDbParameter)	Insère un objet OleDbParameter dans OleDbParameterCollection à l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(Object)	Supprime l'objet Object de OleDbParameterCollection.
Remove(OleDbParameter)	Supprime OleDbParameter de OleDbParameterCollection.
RemoveAt(Int32)	Supprime l'objet OleDbParameter de l'objet OleDbParameterCollection à l'index spécifié.
RemoveAt(String)	Supprime l'objet OleDbParameter de l'objet OleDbParameterCollection au niveau du nom de paramètre spécifié.
SetParameter(Int32, DbParameter)	Affecte une nouvelle valeur à l’objet DbParameter à l’index spécifié. (Hérité de DbParameterCollection)
SetParameter(String, DbParameter)	Affecte une nouvelle valeur à l’objet DbParameter portant le nom spécifié. (Hérité de DbParameterCollection)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Méthodes d’extension

Voir aussi

• Utilisation des commandes
• Utilisation de paramètres avec un DataAdapter