Procédure : ajouter ou supprimer des éléments de liste

Article
09/24/2014

Dernière modification : mardi 16 mars 2010

S’applique à : SharePoint Foundation 2010

Les exemples de cette rubrique montrent comment utiliser le modèle objet serveur SharePoint Foundation pour créer ou supprimer des éléments de liste dans un site Web ou une collection de sites.

Notes

Les exemples de code présentés dans cette rubrique utilisent les membres de la classe Microsoft.SharePoint.SPContext pour obtenir la collection de sites en cours, le site Web ou la liste. En dehors d’un contexte HTTP, comme dans une application console ou une application Windows, les références à des objets clé s’obtiennent à l’aide d’une méthode différente. Au lieu d’un objet Microsoft.SharePoint.SPContext, utilisez le constructeur SPSite() pour instancier une collection de sites spécifique et obtenir des objets. Pour plus d’informations, voir Obtention de références aux sites, applications Web et autres objets clés.

Création d’éléments de liste

Pour ajouter des éléments à une liste, utilisez la méthode Add de la classe SPListItemCollection pour créer un objet élément, puis utilisez la méthode Update de la classe SPListItem pour mettre à jour la base de données avec le nouvel élément.

L’exemple de code suivant suppose l’existence de cinq zones de texte, une qui spécifie le nom de la liste à ajouter, et quatre autres qui sont utilisées pour spécifier les valeurs à ajouter. Les indexeurs sont utilisés pour rassembler les entrées provenant de ces cinq sources. L’exemple présume également que la liste spécifiée par TextBox1.Text existe.

Dim mySite As SPWeb = SPContext.Current.Web
Dim listItems As SPListItemCollection 
    = mySite.Lists(TextBox1.Text).Items

Dim item As SPListItem = listItems.Add()

item("Title") = TextBox2.Text
item("Stock") = Convert.ToInt32(TextBox3.Text)
item("Return Date") = Convert.ToDateTime(TextBox4.Text)
item("Employee") = TextBox5.Text

item.Update()

SPWeb mySite = SPContext.Current.Web;
SPListItemCollection listItems = mySite.Lists[TextBox1.Text].Items;

SPListItem item = listItems.Add();

item["Title"] = TextBox2.Text;
item["Stock"] = Convert.ToInt32(TextBox3.Text);
item["Return Date"] = Convert.ToDateTime(TextBox4.Text);
item["Employee"] = TextBox5.Text;

item.Update();
}

L’exemple de code crée tout d’abord un objet SPListItem via la méthode Add de la collection. Il affecte ensuite des valeurs à des champs spécifiques en utilisant un indexeur sur l’élément de la liste. Par exemple, item["Title"] spécifie la valeur de colonne de titre de l’élément. Enfin, il appelle la méthode Update de l’élément de liste afin d’appliquer les modifications dans la base de données. Vous pouvez aussi utiliser les champs Author, Editor, Created et Modified comme indexeurs, où Author ou Editor spécifie un utilisateur Microsoft SharePoint FoundationID. Pour obtenir un exemple, voir la classe SPListItem.

Suppression d’éléments de liste

Pour supprimer des éléments d’une liste, utilisez la méthode Delete de la classe SPListItemCollection, qui prend comme paramètre un index de la collection.

Dim mySite As SPWeb = SPContext.Current.Web
Dim listItems As SPListItemCollection 
    = mySite.Lists(TextBox1.Text).Items
Dim itemCount As Integer = listItems.Count
Dim k As Integer

For k = 0 To itemCount - 1
    Dim item As SPListItem = listItems(k)

    If TextBox2.Text = item("Employee").ToString() Then
        listItems.Delete(k)
    End If
Next k

SPWeb mySite = SPContext.Current.Web;
SPListItemCollection listItems = mySite.Lists[TextBox1.Text].Items;
int itemCount = listItems.Count;

for (int k=0; k<itemCount; k++)
{
    SPListItem item = listItems[k];

    if (TextBox2.Text==item["Employee"].ToString())
    {
        listItems.Delete(k);
    }
}

En se basant sur les entrées de deux zones de texte, l'exemple de code parcourt la collection d'éléments pour la liste spécifiée et supprime un élément si la valeur du champ Employee correspond à la valeur spécifiée.

Les exemples précédents nécessitent une directive using (Imports en Visual Basic) pour l’espace de noms Microsoft.SharePoint.