Xceed Real-Time Zip for .NET Documentation
AllowSpanning Property


Xceed.Zip Assembly > Xceed.Zip Namespace > ZipArchive Class : AllowSpanning Property
Gets or sets a boolean value indicating if the zip file is allowed to span disks.
Syntax
'Declaration
 
Public Property AllowSpanning As Boolean
'Usage
 
Dim instance As ZipArchive

Dim value As Boolean

 

instance.AllowSpanning = value

 

value = instance.AllowSpanning
public bool AllowSpanning {get; set;}

Property Value

true if the zip file is allowed to span disks; false otherwise (default).
Remarks

If set to false and the destination disk runs out of space, an exception will be thrown. If set to true and the destination disk runs out of space, the DiskRequired event will be raised.

Setting this property to true will result in 4 bytes being written at the beginning of the zip file indicating that the file is a spanned zip file. If this property is always left to true, in the case where the zip file is not spanned, some applications (like WinZip) may report that the zip file is spanned. A zip file that does not span or split, and contains this 4 byte header is still a valid and readable zip file.

When updating a spanned zip file, AllowSpanning must be set to true otherwise the zip file will no longer be spanned.
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