IUpdatable Interface

An interface used to insert or update a resource by the HTTP POST method.

Namespace:  System.Data.Services
Assembly:  Microsoft.Data.Services (in Microsoft.Data.Services.dll)

public interface IUpdatable

The IUpdatable type exposes the following members.

Public methodAddReferenceToCollectionAdds the specified value to the collection.
Public methodClearChangesCancels a change to the data.
Public methodCreateResourceCreates the resource of the specified type and that belongs to the specified container.
Public methodDeleteResourceDeletes the specified resource.
Public methodGetResourceGets the resource of the specified type identified by a query and type name.
Public methodGetValueGets the value of the specified property on the target object.
Public methodRemoveReferenceFromCollectionRemoves the specified value from the collection.
Public methodResetResourceResets the resource identified by the parameter resource to its default value.
Public methodResolveResourceReturns the instance of the resource represented by the specified resource object.
Public methodSaveChangesSaves all the changes that have been made by using the IUpdatable APIs.
Public methodSetReferenceSets the value of the specified reference property on the target object.
Public methodSetValueSets the value of the property with the specified name on the target resource to the specified property value.

The IUpdatable interface is resource independent. The methods that return objects representing resources can return anything.

The returned object is an opaque object that represents the resource. To use the reference to read or update a value, the same opaque object is passed back to IUpdatable.

Implementation of IUpdatable must track the mapping between this opaque object to the object it represents. When the resource is serialized and a common language runtime (CLR) instance of the correct type is needed, the ResolveResource method on IUpdatable is called with the opaque object.

To serialize the object, call the ResolveResource method on IUpdatable.