Classe SqlCeParameterCollection

  • Article

Collecte tous les paramètres propres à SqlCeCommand ainsi que leurs mappages respectifs aux colonnes DataSet.

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbParameterCollection
      System.Data.SqlServerCe.SqlCeParameterCollection

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeParameterCollection _
    Inherits DbParameterCollection
'Utilisation
Dim instance As SqlCeParameterCollection

public sealed class SqlCeParameterCollection : DbParameterCollection

public ref class SqlCeParameterCollection sealed : public DbParameterCollection

[<SealedAttribute>]
type SqlCeParameterCollection =  
    class
        inherit DbParameterCollection
    end

public final class SqlCeParameterCollection extends DbParameterCollection

Le type SqlCeParameterCollection expose les membres suivants.

Propriétés

  Nom Description
Propriété publique Count Obtient le nombre d'objets SqlCeParameter de la collection. (remplace DbParameterCollection.Count.)
Propriété publique IsFixedSize Infrastructure. (remplace DbParameterCollection.IsFixedSize.)
Propriété publique IsReadOnly Infrastructure. (remplace DbParameterCollection.IsReadOnly.)
Propriété publique IsSynchronized Infrastructure. (remplace DbParameterCollection.IsSynchronized.)
Propriété publique Item[Int32] Obtient ou définit SqlCeParameter au niveau de l'index spécifié.
Propriété publique Item[String] Obtient ou définit SqlCeParameter avec le nom spécifié.
Propriété publique SyncRoot Infrastructure. (remplace DbParameterCollection.SyncRoot.)

Haut de la page

Méthodes

  Nom Description
Méthode publique Add(Object) Ajoute un objet SqlCeParameter à SqlCeCommand. (remplace DbParameterCollection.Add(Object).)
Méthode publique Add(SqlCeParameter) Ajoute le SqlCeParameter spécifié à SqlCeParameterCollection.
Méthode publique Add(String, SqlDbType) Ajoute SqlCeParameter à SqlCeParameterCollection en fonction du nom du paramètre et du type de données.
Méthode publique Add(String, Object) Obsolète. Ajoute SqlCeParameter à SqlCeParameterCollection en fonction de la valeur et du nom du paramètre.
Méthode publique Add(String, SqlDbType, Int32) Ajoute SqlCeParameter à SqlCeParameterCollection en fonction du nom du paramètre, du type de données et de la largeur de colonne.
Méthode publique Add(String, SqlDbType, Int32, String) Ajoute SqlCeParameter à SqlCeCommand en fonction du nom du paramètre, du type de données, de la largeur de colonne et du nom de colonne source.
Méthode publique AddRange Ajoute un tableau d'objets SqlCeParameter à SqlCeParameterCollection. (remplace DbParameterCollection.AddRange(Array).)
Méthode publique AddWithValue Ajoute un nouveau SqlCeParameter à SqlCeParameterCollection et définit sa valeur.
Méthode publique Clear Supprime tous les éléments de la collection. (remplace DbParameterCollection.Clear().)
Méthode publique Contains(Object) Obtient une valeur indiquant s'il existe un objet SqlCeParameter dans la collection. (remplace DbParameterCollection.Contains(Object).)
Méthode publique Contains(String) Obtient une valeur indiquant s'il existe dans la collection un SqlCeParameter portant le nom de paramètre spécifié. (remplace DbParameterCollection.Contains(String).)
Méthode publique CopyTo Copie les objets SqlCeParameter de SqlCeParameterCollection dans le tableau spécifié. (remplace DbParameterCollection.CopyTo(Array, Int32).)
Méthode publique CreateObjRef (hérité de MarshalByRefObject)
Méthode publique Equals (hérité de Object)
Méthode protégée Finalize (hérité de Object)
Méthode publique GetEnumerator Infrastructure. (remplace DbParameterCollection.GetEnumerator().)
Méthode publique GetHashCode (hérité de Object)
Méthode publique GetLifetimeService (hérité de MarshalByRefObject)
Méthode protégée GetParameter(Int32) (hérité de DbParameterCollection)
Méthode protégée GetParameter(String) (hérité de DbParameterCollection)
Méthode publique GetType (hérité de Object)
Méthode publique IndexOf(Object) Obtient l'emplacement de l'objet SqlCeParameter dans la collection. (remplace DbParameterCollection.IndexOf(Object).)
Méthode publique IndexOf(String) Obtient l'emplacement du SqlCeParameter portant le nom de paramètre spécifié dans la collection. (remplace DbParameterCollection.IndexOf(String).)
Méthode publique InitializeLifetimeService (hérité de MarshalByRefObject)
Méthode publique Insert Insère SqlCeParameter dans la collection au niveau de l'index spécifié. (remplace DbParameterCollection.Insert(Int32, Object).)
Méthode protégée MemberwiseClone() (hérité de Object)
Méthode protégée MemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publique Remove Enlève le SqlCeParameter spécifié de la collection. (remplace DbParameterCollection.Remove(Object).)
Méthode publique RemoveAt(Int32) Supprime de la collection le SqlCeParameter à l'index spécifié. (remplace DbParameterCollection.RemoveAt(Int32).)
Méthode publique RemoveAt(String) Supprime de la collection le SqlCeParameter portant le nom spécifié. (remplace DbParameterCollection.RemoveAt(String).)
Méthode protégée SetParameter(Int32, DbParameter) (hérité de DbParameterCollection)
Méthode protégée SetParameter(String, DbParameter) (hérité de DbParameterCollection)
Méthode publique ToString (hérité de Object)

Haut de la page

Implémentations d'interfaces explicites

  Nom Description
Implémentation d'interface explicitePropriété privée IList.Item (hérité de DbParameterCollection)
Implémentation d'interface explicitePropriété privée IDataParameterCollection.Item (hérité de DbParameterCollection)

Haut de la page

Notes

Le nombre de paramètres figurant dans la collection doit être équivalent au nombre d'espaces réservés des paramètres dans le texte de la commande. Sinon, le fournisseur de données .NET Compact Framework pour SQL Server Compact peut déclencher une erreur.

Exemples

L'exemple suivant crée plusieurs instances de SqlCeParameter par l'intermédiaire de la collection SqlCeParameterCollection dans SqlCeDataAdapter. Ces paramètres sont utilisés pour sélectionner des données dans la source de données, puis placer les données dans DataSet. Cet exemple part du principe que DataSet et SqlCeDataAdapter ont déjà été créés avec le schéma, les commandes et la connexion appropriés.

Dim cmd As SqlCeCommand = Nothing
Dim adp As SqlCeDataAdapter = Nothing

Try
    adp = New SqlCeDataAdapter()
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")

    ' Create the SelectCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country AND [Ship City] = @city"
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15)
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15)

    cmd.Parameters("@country").Value = "UK"
    cmd.Parameters("@city").Value = "London"

    adp.SelectCommand = cmd

    ' Create the DeleteCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID"

    Dim p As SqlCeParameter = cmd.Parameters.Add("@orderID", SqlDbType.NChar, 5, "Order ID")
    p.SourceVersion = DataRowVersion.Original

    adp.DeleteCommand = cmd

    ' Populate the dataset with the results from the SELECT statement
    '
    Dim ds As New DataSet()
    adp.Fill(ds)

    ' Modify the dataset
    '
    MessageBox.Show("Number of rows: " & ds.Tables(0).Rows.Count)

    ' Delete some rows
    '
    ds.Tables(0).Rows(3).Delete()
    ds.Tables(0).Rows(4).Delete()

    ' This will execute two DELETE statements 
    '
    adp.Update(ds.Tables(0))
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    If Not Nothing Is adp.SelectCommand Then
        adp.SelectCommand.Dispose()
    End If
    If Not Nothing Is adp.DeleteCommand Then
        adp.DeleteCommand.Dispose()
    End If
End Try

SqlCeCommand cmd = null;
SqlCeDataAdapter adp = null;

try
{
    adp = new SqlCeDataAdapter();
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");

    // Create the SelectCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country AND [Ship City] = @city";
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15);
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15);

    cmd.Parameters["@country"].Value = "UK";
    cmd.Parameters["@city"].Value = "London";

    adp.SelectCommand = cmd;

    // Create the DeleteCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID";

    SqlCeParameter p = cmd.Parameters.Add("@orderID", SqlDbType.NChar, 5, "Order ID");
    p.SourceVersion = DataRowVersion.Original;

    adp.DeleteCommand = cmd;

    // Populate the dataset with the results from the SELECT statement
    //
    DataSet ds = new DataSet();
    adp.Fill(ds);

    // Modify the dataset
    //
    MessageBox.Show("Number of rows: " + ds.Tables[0].Rows.Count);

    // Delete some rows
    //
    ds.Tables[0].Rows[3].Delete();
    ds.Tables[0].Rows[4].Delete();

    // This will execute two DELETE statements 
    //
    adp.Update(ds.Tables[0]);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    if (null != adp.SelectCommand) adp.SelectCommand.Dispose();
    if (null != adp.DeleteCommand) adp.DeleteCommand.Dispose();
}

Sécurité des threads

Tout membre statique public (Shared en Microsoft Visual Basic) de ce type est thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe