IHierarchyItem.UpdateProperties Method (Property[], PropertyName[], String)

IT Hit WebDAV for .NET

Updates values of properties exposed by this item.

[Visual Basic]
Sub UpdateProperties( _
   ByVal propertiesToAddOrUpdate As Property(), _
   ByVal propertiesToDelete As PropertyName(), _
   ByVal lockToken As String _
)
[C#]
void UpdateProperties(
   Property[] propertiesToAddOrUpdate,
   PropertyName[] propertiesToDelete,
   string lockToken
);

Parameters

propertiesToAddOrUpdate
Properties to be updated.
propertiesToDelete
Names of properties to be removed from this item.
lockToken
Lock token.

Exceptions

Exception Type Condition
LockedException The item is locked and no or invalid lock token was provided.
PropertyForbiddenException Cannot alter one of the properties.
PropertyConflictException The client has provided a value whose semantics are not appropriate for the property. This includes trying to set read-only properties.
NotFoundException This item doesn't exist on the server.
ConflictException The resource is version controlled and has to be checked out to be edited.
PropertyException Server returned unknown error for specific property.
WebDavHttpException Server returned unknown error.
WebDavException Unexpected error occurred.

Example

 string license = "<?xml version='1.0' encoding='utf...
 WebDavSession session = new WebDavSession(license);
 session.Credentials = new NetworkCredential("User1", "pwd", "DOMAIN");

 IResource resource = session.OpenResource(new Uri("https://server/Library/doc.txt"));

 Property[] propsToAddAndUpdate = new Property[3];
 propsToAddAndUpdate[0] = new Property(new PropertyName("Ammount", "CorpNS"), "1200");
 propsToAddAndUpdate[1] = new Property(new PropertyName("ManagerApproved", "Sales"), "Yes");
 propsToAddAndUpdate[2] = new Property(new PropertyName("Branch", "Sales"), "EMEA Region");

 PropertyName[] propsToDelete = new PropertyName[2];
 propsToDelete[0] = new PropertyName("InternalName", "Sales");
 propsToDelete[1] = new PropertyName("Counter", "CorpNS");

 LockInfo lockInfo = resource.Lock(LockScope.Exclusive, true, "User 1", new TimeSpan(0, 30, 0));
 try
 {
     resource.UpdateProperties(propsToAddAndUpdate, propsToDelete, lockInfo.LockToken.LockToken);
 }
 catch (PropertyException ex)
 {
     Console.WriteLine(ex.Message + " " + ex.Status.Code + " " + ex.Status.Description);
     // Find which properties failed to add/update/delete
     foreach (IPropertyMultistatusResponse propInfo in ex.Multistatus.Responses)
     {
         Console.WriteLine(propInfo.PropertyName + " " + propInfo.Status.Code + " " + propInfo.Status.Description);
     }
 }
 resource.Unlock(lockInfo.LockToken.LockToken);

See Also

IHierarchyItem Interface | ITHit.WebDAV.Client Namespace | IHierarchyItem.UpdateProperties Overload List