Procedimiento para agregar o eliminar elementos de lista

Artículo
09/24/2014

Última modificación: martes, 16 de marzo de 2010

Hace referencia a: SharePoint Foundation 2010

En lo ejemplos de este tema se muestra cómo usar el modelo de objetos de servidor de SharePoint Foundation para crear o eliminar elementos de lista en un sitio web o en una colección de sitios.

Nota

En los ejemplos de código de este tema se usan miembros de la clase Microsoft.SharePoint.SPContext para obtener la colección de sitios, el sitio web o la lista actuales. Fuera de un contexto HTTP, como en una aplicación de consola o una aplicación Windows, se pueden obtener referencias a los objetos clave con un método diferente. En lugar de usar un objeto de Microsoft.SharePoint.SPContext, use el constructor SPSite() para crear una instancia de una colección específica de sitios y obtener objetos. Para obtener más información, vea Obtención de referencias a sitios, aplicaciones web y otros objetos clave.

Creación de elementos de lista

Para agregar elementos a una lista, use el método Add de la clase SPListItemCollection para crear un objeto de elemento y, a continuación, use el método Update de la clase SPListItem para actualizar la base datos con el elemento nuevo.

En el siguiente ejemplo, se presupone la existencia de cinco cuadros de texto, uno para especificar el nombre de la lista a la que se va a agregar elementos, y los otros cuatro para especificar los valores que se van a agregar. Los indizadores recopilan la entrada de los cinco orígenes. En el ejemplo también se presupone que la lista especificada en 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();
}

En el ejemplo, se crea primero un objeto SPListItem con el método Add de la colección. A continuación, se asignan valores a campos específicos mediante un indizador del elemento de lista. Por ejemplo, item["Title"] especifica el valor de columna de título para el elemento. Por último, se llama al método Update del elemento de lista para que los cambios surtan efecto en la base de datos. También se pueden usar los campos Author, Editor, Created y Modified como indizadores, donde Author o Editor especifican un usuario de Microsoft SharePoint FoundationID. Para obtener un ejemplo, vea la clase SPListItem.

Eliminación de elementos de lista

Para eliminar elementos de una lista, use el método Delete de la clase SPListItemCollection, que usa un índice de la colección como parámetro.

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

Según la entrada de los dos cuadros de texto, el ejemplo se repite en la colección de elementos para la lista especificada y elimina un elemento si el valor del campo Empleado coincide con el valor especificado.

En los ejemplos anteriores se requiere una directiva using (Imports en Visual Basic) para el espacio de nombres Microsoft.SharePoint.