CommerceDelete

This operation is used to delete existing commerce entities.

Note: To delete related items or relationships of a commerce entity, use the CommerceUpdate operation.

Class	Description
CommerceOperation	Base class of every operation. PropertyDescription ModelThis property represents the commerce entity of the operation. RelatedOperationsThis list is not used by this operation. It is assumed the deletion of a commerce entity deletes all of the relationships.
CommerceDeleteOperation	Concrete delete operation class. PropertyDescription SearchCriteriaThis property specifies the commerce entity being deleted.
CommerceDeleteOptions	Options for the delete operation. PropertyDescription ReturnDeletedCountThis property indicates the total number of deleted items is to be returned as part of the operation.

Restrictions

If the SearchCriteria type is not supported, the system will throw an exception.

Response

Running a CommerceCreateOperation request creates a CommerceCreateOperationResponse.

Property	Description
CommerceOperationResponse	Base class for every operation.
CommerceDeleteOperationResponse	Response of a DeleteOperation. The Count indicates the number of items that were deleted and is returned only if the DeleteOptions.ReturnDeletedCount is set to True.

CommerceDelete<> Generic Class

The CommerceDelete<> generic class constructs a CommerceDeleteOperation operation or request to send to Microsoft Multi-Channel Commerce Foundation.

Class	Description
CommerceDelete<TItem, TSearch, TOption>	Generic class used to create a request for the CommerceDeleteOperation. PropertyDescription TItemThis item represents the commerce entity type (i.e. the Model) of the delete operation. TSearchThis item represents the SearchCriteria type used to find the commerce entity. TOptionThis item represents the type of CommerceDeleteOptions to be sent as part of the CommerceRequest.
CommerceDelete<TItem, TSearch>	Generic class used to create a request for the CommerceDeleteOperation. PropertyDescription TItemThis item represents the commerce entity type (i.e. the Model) of the delete operation. TSearchThis item represents the SearchCriteria type used to find the commerce entity. The DeleteOptions is defaulted to CommerceDeleteOptionsBuilder which represent the default CommerceDeleteOptions message.
CommerceDelete<TItem >	Generic class used to create a request for the CommerceDeleteOperation. PropertyDescription TItemThis item represents the commerce entity type (i.e. the Model) of the delete operation. The CommerceSearchCriteria is defaulted to CommerceModelSearch of the model represented by TItem.

Example

The following example deletes a UserProfile from the Profiles System.

// Create a Delete<> object specifying the UserProfile commerce entity
// type as the type of commerce entity being deleted.
//
// The second parameter to the Delete<> indicates the type of search to employ.
// In this case the ModelSearch is used to specify the query information that 
// identifies the exact UserProfile to delete.
var deleteUser = new CommerceDelete<CommerceEntity>("UserProfile");

// Specify the Id of the user to delete.
deleteUser.SearchCriteria.Model.Id = "{D3112588-9387-4072-B82C-3A59A21B3D81}";

// Indicate the return count must be returned as part of the response.
deleteUser.Options.ReturnDeletedCount = true;

// Call the service by calling the ProcessRequest() message converting the
// Delete<> content in a Commerce Foundation request.
CommerceResponse response =
 OperationService.ProcessRequest(base.GetCurrentRequestContext(), deleteUser.ToRequest());

CommerceDeleteOperationResponse deleteResponse = response.OperationResponses[0]
    as CommerceDeleteOperationResponse;

Assert.Equals(deleteResponse.Count, 1);

See Also

Other Resources

Developing with the Multi-Channel Commerce Foundation

Commerce Foundation Operations