Ce sujet n'a pas encore été évalué - Évaluez ce sujet

SqlParameterCollection, classe

Mise à jour : novembre 2007

Représente une collection de paramètres associés à SqlCommand et leurs mappages respectifs à des colonnes dans DataSet. Cette classe ne peut pas être héritée.

Espace de noms :  System.Data.SqlClient
Assembly :  System.Data (dans System.Data.dll)

[ListBindableAttribute(false)]
public sealed class SqlParameterCollection : DbParameterCollection
/** @attribute ListBindableAttribute(false) */
public final class SqlParameterCollection extends DbParameterCollection
public final class SqlParameterCollection extends DbParameterCollection

Si la commande contient une instruction SQL ad hoc, par opposition à un nom de procédure stockée, 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, SQL Server génère une erreur. Dans une procédure stockée, tous les paramètres déclarés sans valeur par défaut doivent être fournis. Les paramètres déclarés avec une valeur par défaut sont facultatifs. Cela vous permet de spécifier une valeur autre que la valeur par défaut.

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

public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}


System.Object
  System.MarshalByRefObject
    System.Data.Common.DbParameterCollection
      System.Data.SqlClient.SqlParameterCollection
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ