ZipArchive.CreateFromDirectory Method (String, String)
Creates a Zip archive at the path destinationArchive that contains the files and directories in the directory specified by sourceDirectoryName. The directory structure is preserved in the archive, and a recursive search is done for files to be archived. The archive must not exist. If the directory is empty, an empty archive will be created. If a file in the directory cannot be added to the archive, the archive will be left incomplete and invalid and the method will throw an exception. This method does not include the base directory in the archive. If an error is encountered while adding files to the archive, this method will stop adding files and leave the archive in an invalid state. The paths are permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. If a file in the archive has data in the last write time field that is not a valid Zip timestamp, an indicator value of 1980 January 1 at midnight will be used for the file's last modified time.
If an entry with the specified name already exists in the archive, a second entry will be created that has an identical name. Since no CompressionLevel is specified, the default provided by the implementation of the underlying compression algorithm will be used; the ZipArchive will not impose its own default. (Currently, the underlying compression algorithm is provided by the System.IO.Compression.DeflateStream class.)
Namespace: Microsoft.TeamFoundation.Server.Core
Assembly: Microsoft.TeamFoundation.Server.Core (in Microsoft.TeamFoundation.Server.Core.dll)
Syntax
'Declaration
Public Shared Sub CreateFromDirectory ( _
sourceDirectoryName As String, _
destinationArchiveFileName As String _
)
public static void CreateFromDirectory(
string sourceDirectoryName,
string destinationArchiveFileName
)
public:
static void CreateFromDirectory(
String^ sourceDirectoryName,
String^ destinationArchiveFileName
)
static member CreateFromDirectory :
sourceDirectoryName:string *
destinationArchiveFileName:string -> unit
public static function CreateFromDirectory(
sourceDirectoryName : String,
destinationArchiveFileName : String
)
Parameters
sourceDirectoryName
Type: System.StringThe path to the directory on the file system to be archived.
destinationArchiveFileName
Type: System.StringThe name of the archive to be created.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | sourceDirectoryName or destinationArchive is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars. |
| ArgumentNullException | sourceDirectoryName or destinationArchive is null. |
| PathTooLongException | In sourceDirectoryName or destinationArchive, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. |
| DirectoryNotFoundException | The path specified in sourceDirectoryName or destinationArchive is invalid, (for example, it is on an unmapped drive). -or- The directory specified by sourceDirectoryName does not exist. |
| IOException | destinationArchive exists. -or- An I/O error occurred while opening a file to be archived. |
| UnauthorizedAccessException | destinationArchive specified a directory. -or- The caller does not have the required permission. |
| NotSupportedException | sourceDirectoryName or destinationArchive is in an invalid format. |
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.