Describes how the archive file will be splitted or spanned.

 

[C#]

public ComponentAce.Compression.Archiver.SpanningOptions SpanningOptions { get; set; }

 

public class SpanningOptions

{

  // Methods

  public SpanningOptions();

  public void Assign(object Source);

 

  // Properties

  public bool AdvancedNaming { get; set; }

  public long CustomVolumeSize { get; set; }

  public long FirstVolumeSize { get; set; }

  public ComponentAce.Compression.Archiver.VolumeSize VolumeSize { get; set; }

}

 

[VB.NET]

Public Property SpanningOptions As SpanningOptions

 

Public Class SpanningOptions

  ' Methods

  Public Sub New()

  Public Sub Assign(ByVal Source As Object)

 

  ' Properties

  Public Property AdvancedNaming As Boolean

  Public Property CustomVolumeSize As Long

  Public Property FirstVolumeSize As Long

  Public Property VolumeSize As VolumeSize

End Class

 

Description

 

SpanningOptions property determines how the archive file will be splitted or spanned.

 

The AdvancedNaming determines how the archive volumes will be named.

If AdvancedNaming is set to True then archive volumes will be named like archive_001.zip, archive_002.zip, ... ,

archive_999.zip.

If AdvancedNaming is set to False and SpanningMode is set to smSpanning then archive volumes will be named like archive.zip on each removable disk.

If AdvancedNaming is set to False and SpanningMode is set to smSplitting then archive volumes will be named like archive.z01,

archive.z02, ... , archive.z99.

You can also specify custom name for each volume using OnRequestBlankVolume event handler.

 

The FirstVolumeSize specifies the size of first volume, minimum size is 64 Kb. If the FirstVolumeSize is set to 0 the size of the first volume will be the same as other volumes and will be defined by VolumeSize value.

 

The VolumeSize specifies the size of the volumes for archive splitting or spanning. If the VolumeSize is set to vsCustom, then CustomVolumeSize will be used.

 

The CustomVolumeSize specifies the custom size of the volumes for archive splitting or spanning. This parameter can be used only when VolumeSize is set to vsCustom.