Version imprimable       Envoyer     
Cliquez pour évaluer et commenter
TechNet
Bibliothèque TechNet
SQL Server
SQL Server Compact 4.0
Référence technique de SQ...
Réduire tout/Développer tout Réduire tout
Cette page est spécifique à
Microsoft Visual Studio 2010/.NET Framework 4

D'autres versions sont également disponibles pour :
Classe SqlCeParameterCollection

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

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)
Visual Basic (Déclaration)
Public NotInheritable Class SqlCeParameterCollection _
    Inherits DbParameterCollection
Visual Basic (Utilisation)
Dim instance As SqlCeParameterCollection
C#
public sealed class SqlCeParameterCollection : DbParameterCollection
Visual C++
public ref class SqlCeParameterCollection sealed : public DbParameterCollection
F#
[<SealedAttribute>]
type SqlCeParameterCollection =  
    class
        inherit DbParameterCollection
    end
JScript
public final class SqlCeParameterCollection extends DbParameterCollection

Le type SqlCeParameterCollection expose les membres suivants.

  NomDescription
Propriété publiqueCountObtient le nombre d'objets SqlCeParameter de la collection. (remplace DbParameterCollection..::.Count.)
Propriété publiqueIsFixedSizeInfrastructure. (remplace DbParameterCollection..::.IsFixedSize.)
Propriété publiqueIsReadOnlyInfrastructure. (remplace DbParameterCollection..::.IsReadOnly.)
Propriété publiqueIsSynchronizedInfrastructure. (remplace DbParameterCollection..::.IsSynchronized.)
Propriété publiqueItem[([(Int32])])Obtient ou définit SqlCeParameter au niveau de l'index spécifié.
Propriété publiqueItem[([(String])])Obtient ou définit SqlCeParameter avec le nom spécifié.
Propriété publiqueSyncRootInfrastructure. (remplace DbParameterCollection..::.SyncRoot.)
Haut de la page
  NomDescription
Méthode publiqueAdd(Object)Ajoute un objet SqlCeParameter à SqlCeCommand. (remplace DbParameterCollection..::.Add(Object).)
Méthode publiqueAdd(SqlCeParameter)Ajoute le SqlCeParameter spécifié à SqlCeParameterCollection.
Méthode publiqueAdd(String, SqlDbType)Ajoute SqlCeParameter à SqlCeParameterCollection en fonction du nom du paramètre et du type de données.
Méthode publiqueAdd(String, Object) Obsolète. Ajoute SqlCeParameter à SqlCeParameterCollection en fonction de la valeur et du nom du paramètre.
Méthode publiqueAdd(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 publiqueAdd(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 publiqueAddRangeAjoute un tableau d'objets SqlCeParameter à SqlCeParameterCollection. (remplace DbParameterCollection..::.AddRange(Array).)
Méthode publiqueAddWithValueAjoute un nouveau SqlCeParameter à SqlCeParameterCollection et définit sa valeur.
Méthode publiqueClearSupprime tous les éléments de la collection. (remplace DbParameterCollection..::.Clear()()().)
Méthode publiqueContains(Object)Obtient une valeur indiquant s'il existe un objet SqlCeParameter dans la collection. (remplace DbParameterCollection..::.Contains(Object).)
Méthode publiqueContains(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 publiqueCopyToCopie les objets SqlCeParameter de SqlCeParameterCollection dans le tableau spécifié. (remplace DbParameterCollection..::.CopyTo(Array, Int32).)
Méthode publiqueCreateObjRef (hérité de MarshalByRefObject)
Méthode publiqueEquals (hérité de Object)
Méthode protégéeFinalize (hérité de Object)
Méthode publiqueGetEnumeratorInfrastructure. (remplace DbParameterCollection..::.GetEnumerator()()().)
Méthode publiqueGetHashCode (hérité de Object)
Méthode publiqueGetLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeGetParameter(Int32) (hérité de DbParameterCollection)
Méthode protégéeGetParameter(String) (hérité de DbParameterCollection)
Méthode publiqueGetType (hérité de Object)
Méthode publiqueIndexOf(Object)Obtient l'emplacement de l'objet SqlCeParameter dans la collection. (remplace DbParameterCollection..::.IndexOf(Object).)
Méthode publiqueIndexOf(String)Obtient l'emplacement du SqlCeParameter portant le nom de paramètre spécifié dans la collection. (remplace DbParameterCollection..::.IndexOf(String).)
Méthode publiqueInitializeLifetimeService (hérité de MarshalByRefObject)
Méthode publiqueInsertInsère SqlCeParameter dans la collection au niveau de l'index spécifié. (remplace DbParameterCollection..::.Insert(Int32, Object).)
Méthode protégéeMemberwiseClone()()() (hérité de Object)
Méthode protégéeMemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publiqueRemoveEnlève le SqlCeParameter spécifié de la collection. (remplace DbParameterCollection..::.Remove(Object).)
Méthode publiqueRemoveAt(Int32)Supprime de la collection le SqlCeParameter à l'index spécifié. (remplace DbParameterCollection..::.RemoveAt(Int32).)
Méthode publiqueRemoveAt(String)Supprime de la collection le SqlCeParameter portant le nom spécifié. (remplace DbParameterCollection..::.RemoveAt(String).)
Méthode protégéeSetParameter(Int32, DbParameter) (hérité de DbParameterCollection)
Méthode protégéeSetParameter(String, DbParameter) (hérité de DbParameterCollection)
Méthode publiqueToString (hérité de Object)
Haut de la page

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.

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.

Visual Basic
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
C#
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();
}
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.
© 2012 Microsoft. Tous droits réservés. Conditions d'utilisation | Marques | Confidentialité
Page view tracker