DataServiceContext.UpdateObject(Object) Método

Referencia

Definición

Espacio de nombres:: System.Data.Services.Client

Ensamblado:: System.Data.Services.Client.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Cambia el estado del objeto especificado en DataServiceContext a Modified.

public:
 void UpdateObject(System::Object ^ entity);

public void UpdateObject (object entity);

member this.UpdateObject : obj -> unit

Public Sub UpdateObject (entity As Object)

Parámetros

entity: Object

Entidad de la que se ha realizado un seguimiento que se va a asignar al estado Modified.

Excepciones

ArgumentNullException

Cuando entity es null.

ArgumentException

Cuando entity se encuentra en el estado Detached.

Ejemplos

En el siguiente ejemplo se recupera y modifica un objeto existente y, a continuación, se llama al método UpdateObject en DataServiceContext para marcar el elemento en el contexto cuando se actualice. Cuando se llama a SaveChanges se envía un mensaje HTTP MERGE al servicio de datos. En este ejemplo se usa la DataServiceContext generada por la herramienta Agregar referencia de servicio basada en el servicio de datos Northwind, que se crea al completar el WCF Data Services .

string customerId = "ALFKI";

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Get a customer to modify using the supplied ID.
var customerToChange = (from customer in context.Customers
                        where customer.CustomerID == customerId
                        select customer).Single();

// Change some property values.
customerToChange.CompanyName = "Alfreds Futterkiste";
customerToChange.ContactName = "Maria Anders";
customerToChange.ContactTitle = "Sales Representative";

try
{
    // Mark the customer as updated.
    context.UpdateObject(customerToChange);

    // Send the update to the data service.
    context.SaveChanges();
}
catch (DataServiceRequestException  ex)
{
    throw new ApplicationException(
        "An error occurred when saving changes.", ex);
}

Dim customerId = "ALFKI"

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Get a customer to modify using the supplied ID.
Dim customerToChange = (From customer In context.Customers _
                        Where customer.CustomerID = customerId _
                        Select customer).Single()

' Change some property values.
customerToChange.CompanyName = "Alfreds Futterkiste"
customerToChange.ContactName = "Maria Anders"
customerToChange.ContactTitle = "Sales Representative"

Try
    ' Mark the customer as updated.
    context.UpdateObject(customerToChange)

    ' Send the update to the data service.
    context.SaveChanges()
Catch ex As DataServiceRequestException
    Throw New ApplicationException( _
            "An error occurred when saving changes.", ex)
End Try

Se aplica a