Xceed Real-Time Zip for .NET Documentation
BeginUpdate(FileSystemEvents,Object) Method


Xceed.Zip Assembly > Xceed.Zip Namespace > ZipArchive Class > BeginUpdate Method : BeginUpdate(FileSystemEvents,Object) Method
A Xceed.FileSystem.FileSystemEvents object that will be used to raise events. Cannot be a null reference (Nothing in Visual Basic).
Opaque data that will be passed back to the event handler when an event is raised.
Prevents a ZipArchive object from modifying its underlying physical store until the EndUpdate method is called and raises events during the process.
Syntax
'Declaration
 
Public Overloads Sub BeginUpdate( _
   ByVal events As Xceed.FileSystem.FileSystemEvents, _
   ByVal userData As Object _
) 
'Usage
 
Dim instance As ZipArchive
Dim events As Xceed.FileSystem.FileSystemEvents
Dim userData As Object
 
instance.BeginUpdate(events, userData)
public void BeginUpdate( 
   Xceed.FileSystem.FileSystemEvents events,
   object userData
)

Parameters

events
A Xceed.FileSystem.FileSystemEvents object that will be used to raise events. Cannot be a null reference (Nothing in Visual Basic).
userData
Opaque data that will be passed back to the event handler when an event is raised.
Remarks

A call to BeginUpdate must be accompanied by a subsequent call to EndUpdate, or desynchronization can occur. One way of making sure that both calls stay synchronized is to use a finally block:


try 
{
  i.BeginUpdate();
  // Do some modifications to the zip file
}
finally 
{
  i.EndUpdate();
}

In C#, the preferred way is to use the Xceed.FileSystem.AutoBatchUpdate class within a using statement.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

ZipArchive Class
ZipArchive Members
Overload List