Compartir a través de

Procedimiento para actualizar elementos de listas

  • Artículo

Esta tarea de programación muestra cómo usar el método UpdateListItems del servicio web Lists para actualizar elementos de una lista a través de una aplicación de Microsoft Windows.

Utilice un objeto System.Xml.XmlElement para crear un elemento Batch en el Collaborative Application Markup Language (CAML) que pueda contener varios elementos Método y utilice el método UpdateListItems para registrar los métodos y actualizar los elementos. El atributo Cmd de cada elemento Method determina la operación que se realiza en un elemento especificando uno de los siguientes valores:

  • Delete -- Eliminar un elemento.

  • New -- Crear un elemento.

  • Update -- Modificar un elemento.

Procedimientos

Antes de empezar, cree una aplicación de Windows como se describe en Introducción a la personalización mediante programación de un sitio web de SharePoint en Visual Studio. Para obtener información sobre cómo establecer una referencia web para un servicio web de Windows SharePoint Services, consulte Instrucciones para los servicios web.

Nota

En el ejemplo se presupone la existencia de una lista denominada "MyList" que contiene al menos

Para agregar código para actualizar los elementos de una lista

  1. Abra Form1 en la vista Diseño, abra el Cuadro de herramientas y luego arrastre un control de Button al formulario.

  2. Haga doble clic en el control Button1 para mostrar el editor de código y, a continuación, agregue las siguientes líneas de código al controlador de eventos Click:

    'Declare and initialize a variable for the Lists Web service.
Dim listService As New sitesWebServiceLists.Lists()

'Authenticate the current user by passing their default
'credentials to the Web service from the system credential cache.
listService.Credentials = System.Net.CredentialCache.DefaultCredentials

'Set the Url property of the service for the path to a subsite.
listService.Url = "http://MyServer/sites/MySiteCollection/_vti_bin/Lists.asmx"

'Get Name attribute values (GUIDs) for list and view. 
Dim ndListView As System.Xml.XmlNode = listService.GetListAndView("MyList", "")
Dim strListID As String = ndListView.ChildNodes(0).Attributes("Name").Value
Dim strViewID As String = ndListView.ChildNodes(1).Attributes("Name").Value

'Create an XmlDocument object and construct a Batch element and its 'attributes. Note that an empty ViewName parameter causes the method 'to use the default view. 
Dim doc As New System.Xml.XmlDocument()
Dim batchElement As System.Xml.XmlElement = doc.CreateElement("Batch")
batchElement.SetAttribute("OnError", "Continue")
batchElement.SetAttribute("ListVersion", "1")
batchElement.SetAttribute("ViewName", strViewID)

'Specify methods for the batch post using CAML. To update or delete, 'specify the ID of the item, and to update or add, specify 
'the value to place in the specified columns.
batchElement.InnerXml = "<Method ID='1' Cmd='Update'>" +
   "<Field Name='ID'>6</Field>" +
   "<Field Name='Title'>Modified sixth item</Field></Method>" +
   "<Method ID='2' Cmd='Update'><Field Name='ID'>7</Field>" +
   "<Field Name='Title'>Modified seventh item</Field></Method>" +
   "<Method ID='3' Cmd='Delete'><Field Name='ID'>5</Field>" +
   "</Method><Method ID='4' Cmd='New'>" +
   "<Field Name='Title'>Added item</Field></Method>"

'Update list items. This example uses the list GUID, which is recommended, but the list display name will also work.
listService.UpdateListItems(strListID, batchElement)

    /*Declare and initialize a variable for the Lists Web service.*/
sitesWebServiceLists.Lists listService = new sitesWebServiceLists.Lists();

/*Authenticate the current user by passing their default
credentials to the Web service from the system credential cache.*/
listService.Credentials =
System.Net.CredentialCache.DefaultCredentials;

/*Set the Url property of the service for the path to a subsite.*/
listService.Url = "http://MyServer/sites/MySiteCollection/_vti_bin/Lists.asmx";

/*Get Name attribute values (GUIDs) for list and view. */
System.Xml.XmlNode ndListView = listService.GetListAndView("MyList", "");
string strListID = ndListView.ChildNodes[0].Attributes["Name"].Value;
string strViewID = ndListView.ChildNodes[1].Attributes["Name"].Value;

/*Create an XmlDocument object and construct a Batch element and its attributes. Note that an empty ViewName parameter causes the method to use the default view. */
System.Xml.XmlDocument doc = new System.Xml.XmlDocument();
System.Xml.XmlElement batchElement = doc.CreateElement("Batch");
batchElement.SetAttribute("OnError", "Continue");
batchElement.SetAttribute("ListVersion", "1");
batchElement.SetAttribute("ViewName", strViewID);

/*Specify methods for the batch post using CAML. To update or delete, specify the ID of the item, and to update or add, specify 
the value to place in the specified column.*/
batchElement.InnerXml = "<Method ID='1' Cmd='Update'>" +
   "<Field Name='ID'>6</Field>" +
   "<Field Name='Title'>Modified sixth item</Field></Method>" +
   "<Method ID='2' Cmd='Update'><Field Name='ID'>7</Field>" +
   "<Field Name='Title'>Modified seventh item</Field></Method>" +
   "<Method ID='3' Cmd='Delete'><Field Name='ID'>5</Field>" +
   "</Method><Method ID='4' Cmd='New'>" +
   "<Field Name='Title'>Added item</Field></Method>";

/*Update list items. This example uses the list GUID, which is recommended, but the list display name will also work.*/
try
{
   listService.UpdateListItems(strListID, batchElement);
}
catch (SoapServerException ex)
{
   MessageBox.Show(ex.Message);
}

    Nota

    En el registro del método UpdateListItems se producirá silenciosamente un error si un elemento especificado no existe. El identificador de un elemento eliminado se mantiene después de una operación de eliminación. Por lo tanto, en el ejemplo se elimina el quinto elemento de la lista, pero no se vuelve a asignar el 5 como identificador de otro elemento.

  3. En el menú Depurar, haga clic en Iniciar depuración o presione F5 para probar el formulario.