Xceed .NET Libraries Documentation
DoOpenWrite(FileSystemEventsSession,Boolean,FileShare,CompressionMethod,CompressionLevel,String) Method


Xceed.Zip Assembly > Xceed.Zip Namespace > ZippedFile Class > DoOpenWrite Method : DoOpenWrite(FileSystemEventsSession,Boolean,FileShare,CompressionMethod,CompressionLevel,String) Method
A reference to a Xceed.FileSystem.FileSystemEventsSession object which is responsible for raising all events that occur during the process.
true if existing data for the file should be replaced; false if existing data should be preserved, appending new data at the end.
A System.IO.FileShare constant that determines how the file will be shared by different processes.
The CompressionMethod that will be used to compress the file.
The CompressionLevel that will be used when compressing the file.
The password that will be used to encrypt the file.
Opens the file for writing with the specified System.IO.FileShare constant and password.
Syntax
'Declaration
 
Protected Overloads Function DoOpenWrite( _

   ByVal session As FileSystemEventsSession, _

   ByVal overwrite As Boolean, _

   ByVal share As FileShare, _

   ByVal compressionMethod As CompressionMethod, _

   ByVal compressionLevel As CompressionLevel, _

   ByVal encryptionPassword As String _

) As Stream
'Usage
 
Dim instance As ZippedFile

Dim session As FileSystemEventsSession

Dim overwrite As Boolean

Dim share As FileShare

Dim compressionMethod As CompressionMethod

Dim compressionLevel As CompressionLevel

Dim encryptionPassword As String

Dim value As Stream

 

value = instance.DoOpenWrite(session, overwrite, share, compressionMethod, compressionLevel, encryptionPassword)

Parameters

session
A reference to a Xceed.FileSystem.FileSystemEventsSession object which is responsible for raising all events that occur during the process.
overwrite
true if existing data for the file should be replaced; false if existing data should be preserved, appending new data at the end.
share
A System.IO.FileShare constant that determines how the file will be shared by different processes.
compressionMethod
The CompressionMethod that will be used to compress the file.
compressionLevel
The CompressionLevel that will be used when compressing the file.
encryptionPassword
The password that will be used to encrypt the file.

Return Value

A System.IO.Stream object that can be used to write data to the file.
Remarks

The returned stream is guaranteed to be writable, but may or may not be seekable.

If there is no existing data, the parameter overwrite is ignored.

The compression level only applies to the Deflated and Deflated64 compression methods.  It does not apply to the BZip2, BWT, or PPMd compression methods.

The PPMd algorithm uses a custom memory management system called SubAllocator. In a zip file, the memory size the SubAllocator uses is defined in the WinZip PPMd header for the compressed file and this header's value is used when decompressing the data. In general, WinZip uses 64Mb. Since the algorithm used was not optimized from the original PPMd version I revision 1, the SubAllocator initially requires the total amount of memory specified in the PPMd compressor. This means you must have at least 64 free Mb of RAM when using this compression method.

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

ZippedFile Class
ZippedFile Members
Overload List