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)

'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.

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

Haut de la page

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

Haut de la page

	Nom	Description
	IList.Item	(hérité de DbParameterCollection)
	IDataParameterCollection.Item	(hérité de DbParameterCollection)

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.

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();
}

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.

Espace de noms System.Data.SqlServerCe