Azure Integrator V2 - Online Help
Azure Integrator V2
Questions / Feedback?

IfMatch Property

Specifies the condition for which the update/merge/delete should be performed.

Syntax

[VB.NET]
Public Property IfMatch As String

[C#]
public string IfMatch {get; set;}

Remarks

This property is used when calling MergeEntity to determine the condition for updating. This property may be set to an ETag value in order to perform a conditional update. When calling MergeEntity if IfMatch is specified the Azure service will compare the value to the current ETag of the item that is being updated. The ETag value for an entity may be read from EntityETag after calling ListEntities.

To perform an update first call GetEntity. You may then modify EntityProperties or add new properties with AddEntityProperty.

When performing the update, if the current ETag of the entity on the Azure server matches the value specified by IfMatch, the merge is performed. If they do not match the merge is not performed and the Azure service will return HTTP Error 412 (Precondition failed).

This design allows you to verify that no changes have been made to the entity since the time at which you stored the ETag value. This acts as way to guard against overwriting updates that occurred between the time you retrieved the entity and the time you call MergeEntity.

To perform an unconditional update leave IfMatch blank.

When merging the Azure service will only add or update the properties set in EntityProperties. Existing properties not included in EntityProperties will not be modified. Properties included in EntityProperties will be updated. Any new properties included in EntityProperties will be added.

Note: to remove a property you must use UpdateEntity.

Default Value

""

 
 
Copyright (c) 2017 /n software inc. - All rights reserved.
Build 2.0.6240.0