Xceed Zip Compression Library Documentation
SplitSize property
Xceed Zip control reference > Xceed Zip control properties > SplitSize property

Description

The SplitSize property let you create multi-part zip files , or lets you limit the amount of data written to each disk when creating a spanned zip file . Listed below are the effects of the SplitSize property depending on the value of the SpanMultipleDisks property:  

SpanMultipleDisks property value Effect of the SplitSize property
xcdNever If the SplitSize property is set to zero (0), the library will create regular zip files (not spanned, not multi-part).

If the SplitSize property is set to a non-zero value, any zip files created by the library will be written to the destination folder in the form of a multi-part zip file. Each part's size (in bytes) will be equal to the value indicated by the SplitSize property, except for the last part which may be smaller. The file representing the first part of the zip file will have the ".zip" filename extension, while the remaining parts will be have the extensions ".z02", ".z03", and so on. These zip file parts are identical to spanned zip files, except that they are not located on different removable media disks and each part has a different filename.
xdsAlways or xdsRemovableDrivesOnly If the SplitSize property is set to zero (0), the library will create spanned zip files that will attempt to fill up all the available space on each floppy disk or removable media. (The FirstDiskFreeSpace property can affect the amount of free space left on the first disk, though.)

If the SplitSize property is set to a non-zero value, the amount of data written to each floppy disk or removable media is limited to the amount specified in the SplitSize property.

Data type

Long Integer

Possible values

0 to 4294967295 or
0 to 2147483647 for languages with signed long integers such as VB

Default value

0

Declaration (DLL API)  

DWORD XzGetSplitSize( HXCEEDZIP hZip )

void XzSetSplitSize( HXCEEDZIP hZip, DWORD dwValue )

Remarks

You can use the SplitSize property in conjunction with the SpanMultipleDisks property to create spanned zip files that are limited to a specific size and do not necessarily fill up the entire removable media disk.

If the split zip file needs to have parts larger than 4 gigabytes, use the SplitSize64 property instead of this one. It accepts 64-bit values, which will allow the required range. On systems that cannot easily manipulate 64-bit values, use the SplitSizeHigh property, which accesses the higher 32 bits of the 64-bit value.

The SplitSize, SplitSizeHigh and SplitSize64 properties refer to the same 64-bit value: SplitSize accesses the low 32 bits of the value, SplitSizeHigh accesses the higher 32 bits of the value, while the SplitSize64 accesses the entire 64 bits of the value at the same time.

For information on how to convert to and from 64-bit values, refer to the 64-bit values topic.

Applicable methods

Zip, Convert

Related properties

SplitSizeHigh, SplitSize64, SpanMultipleDisks