Rebex
Products Downloads Buy Support Contact
Show / Hide Table of Contents

ZipArchive.AddFile Method

Namespace: Rebex.IO.Compression
Assembly: Rebex.Zip.dll (version 7.0.9147)

AddFile(String)

Adds the specified file to the root directory of the ZIP archive.

Declaration
public ArchiveOperationResult AddFile(string sourceFilePath)
Parameters
Type Name Description
String sourceFilePath

Path to a local file to be added.

Returns
Type Description
ArchiveOperationResult

Operation result.

Exceptions
Type Condition
ArgumentNullException

sourceFilePath is null.

ArgumentException

The specified path is empty or contains invalid characters. -or- The system could not retrieve the absolute path.

InvalidOperationException

Archive is not opened for writing. -or- sourceFilePath refers to the ZIP archive itself.

ObjectDisposedException

Archive was already disposed.

NotSupportedException

Path is in an invalid format.

PathTooLongException

sourceFilePath exceed the maximum length defined by system.

DirectoryNotFoundException

Part of the specified path was not found.

FileNotFoundException

The specified file path was not found.

SecurityException

The caller does not have the required permissions.

UnauthorizedAccessException

Access to the file is denied.

IOException

An I/O error occurred.

ZipException

Cannot perform the requested operation, or the operation was canceled (see ProblemType for detailed information).

AddFile(String, String)

Adds the specified local file to the specified directory within the ZIP archive.

Declaration
public ArchiveOperationResult AddFile(string sourceFilePath, string archivePath)
Parameters
Type Name Description
String sourceFilePath

Path to a local file to be added.

String archivePath

Path to a (non-existing) file archive item or path to a directory item ending with directory separator (typically ''). Null reference (Nothing in Visual Basic) means root.

Returns
Type Description
ArchiveOperationResult

Operation result.

Exceptions
Type Condition
ArgumentNullException

sourceFilePath is null.

ArgumentException

The specified path is empty or contains invalid characters. -or- The system could not retrieve the absolute path.

InvalidOperationException

Archive is not opened for writing. -or- sourceFilePath refers to the ZIP archive itself.

ObjectDisposedException

Archive was already disposed.

NotSupportedException

Path is in an invalid format.

PathTooLongException

sourceFilePath exceed the maximum length defined by system. -or- archivePath is longer than 65.535 characters.

DirectoryNotFoundException

Part of the source path was not found.

FileNotFoundException

The source file was not found.

SecurityException

The caller does not have the required permissions.

UnauthorizedAccessException

Access to the file is denied.

IOException

An I/O error occurred.

ZipException

Cannot perform the requested operation, or the operation was canceled (see ProblemType for detailed information).

AddFile(String, String, ActionOnExistingFiles)

Adds the specified local file to the specified directory within the ZIP archive.

Declaration
public ArchiveOperationResult AddFile(string sourceFilePath, string archivePath, ActionOnExistingFiles defaultActionOnExistingFiles)
Parameters
Type Name Description
String sourceFilePath

Path to a local file to be added.

String archivePath

Path to a (non-existing) file archive item or path to a directory item ending with directory separator (typically ''). Null reference (Nothing in Visual Basic) means root.

ActionOnExistingFiles defaultActionOnExistingFiles

Specifies the default behavior for files that already exists in the local directory.

Returns
Type Description
ArchiveOperationResult

Operation result.

Exceptions
Type Condition
ArgumentNullException

sourceFilePath is null.

ArgumentException

The specified path is empty or contains invalid characters. -or- The system could not retrieve the absolute path.

InvalidOperationException

Archive is not opened for writing. -or- sourceFilePath refers to the ZIP archive itself.

ObjectDisposedException

Archive was already disposed.

NotSupportedException

Path is in an invalid format.

PathTooLongException

sourceFilePath exceed the maximum length defined by system. -or- archivePath is longer than 65.535 characters.

DirectoryNotFoundException

Part of the source path was not found.

FileNotFoundException

The source file was not found.

SecurityException

The caller does not have the required permissions.

UnauthorizedAccessException

Access to the file is denied.

IOException

An I/O error occurred.

ZipException

Cannot perform the requested operation, or the operation was canceled (see ProblemType for detailed information).

AddFile(Stream, String)

Adds data from the specified stream to the ZIP archive.

Declaration
public ArchiveOperationResult AddFile(Stream inputStream, string archiveFilePath)
Parameters
Type Name Description
Stream inputStream

Stream to read the data from.

String archiveFilePath

Absolute path to a (non-existing) file item within the ZIP archive.

Returns
Type Description
ArchiveOperationResult

Operation result.

Remarks

Note that only data following the current position of the input stream is compressed.

Exceptions
Type Condition
ArgumentNullException

inputStream is null.

ArgumentException

archiveFilePath is empty or contains invalid characters.

InvalidOperationException

Archive is not opened for writing. -or- inputStream refers to the ZIP archive itself.

ObjectDisposedException

Archive was already disposed.

PathTooLongException

archiveFilePath is longer than 65.535 characters.

IOException

An I/O error occurred.

ZipException

Cannot perform the requested operation, or the operation was canceled (see ProblemType for detailed information).

AddFile(Stream, String, ActionOnExistingFiles)

Adds data from the specified stream to the ZIP archive.

Declaration
public ArchiveOperationResult AddFile(Stream inputStream, string archiveFilePath, ActionOnExistingFiles defaultActionOnExistingFiles)
Parameters
Type Name Description
Stream inputStream

Stream to read the data from.

String archiveFilePath

Absolute path to a (non-existing) file item within the ZIP archive.

ActionOnExistingFiles defaultActionOnExistingFiles

Specifies the default behavior for files that already exists in the local directory.

Returns
Type Description
ArchiveOperationResult

Operation result.

Remarks

Note that only data following the current position of the input stream is compressed.

Exceptions
Type Condition
ArgumentNullException

inputStream is null.

ArgumentException

archiveFilePath is empty or contains invalid characters.

InvalidOperationException

Archive is not opened for writing. -or- inputStream refers to the ZIP archive itself.

ObjectDisposedException

Archive was already disposed.

PathTooLongException

archiveFilePath is longer than 65.535 characters.

IOException

An I/O error occurred.

ZipException

Cannot perform the requested operation, or the operation was canceled (see ProblemType for detailed information).

In This Article
© REBEX ČR s.r.o. Back to top
Privacy policy
Manage cookies