Share via


Sync.PutUpdate Method

Office Developer Reference

Updates the server copy of the shared document with the local copy.

Syntax

expression.PutUpdate

expression   A variable that represents a Sync object.

Remarks

The PutUpdate method can encounter a conflict condition if the client is unaware of recent changes to the server copy of the shared document. Call the GetUpdate method before calling PutUpdate to refresh the status of the server copy and to detect a possible conflict.

The PutUpdate method raises a run-time error if the local document has unsaved changes.

Not all document synchronization problems raise trappable run-time errors. After performing an operation using the Sync object, it's a good idea to check the Status property; if the Status property is msoSyncStatusError, check the ErrorType property for additional information on the type of error that has occurred.

In many circumstances, the best way to resolve an error condition is to call the GetUpdate method. For example, if a call to PutUpdate results in an error condition, then a call to GetUpdate will reset the status to msoSyncStatusLocalChanges.

Example
The following example updates the server copy of the document from the local copy using the PutUpdate method if the local copy has been edited.

Visual Basic for Applications
      Dim objSync As Office.Sync
    Dim strStatus As String
    Set objSync = ActiveDocument.Sync
    If objSync.Status = msoSyncStatusLocalChanges Then
        objSync.PutUpdate
        strStatus = "Local changes saved to server."
        MsgBox strStatus, vbInformation + vbOKOnly, "Sync Information"
    End If
    Set objSync = Nothing

See Also