ZipFileExtensions.CreateEntryFromFile Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip.
CreateEntryFromFile(ZipArchive, String, String) |
Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip. |
CreateEntryFromFile(ZipArchive, String, String, CompressionLevel) |
Arquiva um arquivo, compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip. |
Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip.
public:
[System::Runtime::CompilerServices::Extension]
static System::IO::Compression::ZipArchiveEntry ^ CreateEntryFromFile(System::IO::Compression::ZipArchive ^ destination, System::String ^ sourceFileName, System::String ^ entryName);
public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName);
static member CreateEntryFromFile : System.IO.Compression.ZipArchive * string * string -> System.IO.Compression.ZipArchiveEntry
<Extension()>
Public Function CreateEntryFromFile (destination As ZipArchive, sourceFileName As String, entryName As String) As ZipArchiveEntry
Parâmetros
- destination
- ZipArchive
O arquivo zip ao qual o arquivo será adicionado.
- sourceFileName
- String
O caminho para o arquivo a ser arquivado. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.
- entryName
- String
O nome da entrada a ser criada no arquivo zip.
Retornos
Um wrapper para a nova entrada no arquivo zip.
Exceções
sourceFileName
é Empty, contém somente espaços em branco ou, pelo menos, um caractere inválido.
- ou -
entryName
é Empty.
sourceFileName
ou entryName
é null
.
Em sourceFileName
, o caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.
sourceFileName
é inválido (por exemplo, está em uma unidade não mapeada).
O arquivo especificado por sourceFileName
não pode ser aberto ou é muito grande para ser atualizado (o limite atual é Int32.MaxValue).
sourceFileName
especifica um diretório.
- ou -
O chamador não tem a permissão necessária para acessar o arquivo especificado por sourceFileName
.
O arquivo especificado por sourceFileName
não foi encontrado.
O parâmetro sourceFileName
está em um formato inválido.
- ou -
O arquivo zip não dá suporte à gravação.
O arquivo zip foi descartado.
Exemplos
O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente.
using System;
using System.IO;
using System.IO.Compression;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string zipPath = @"c:\users\exampleuser\start.zip";
string extractPath = @"c:\users\exampleuser\extract";
string newFile = @"c:\users\exampleuser\NewFile.txt";
using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
{
archive.CreateEntryFromFile(newFile, "NewEntry.txt");
archive.ExtractToDirectory(extractPath);
}
}
}
}
Imports System.IO
Imports System.IO.Compression
Module Module1
Sub Main()
Dim zipPath As String = "c:\users\exampleuser\end.zip"
Dim extractPath As String = "c:\users\exampleuser\extract"
Dim newFile As String = "c:\users\exampleuser\NewFile.txt"
Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
archive.ExtractToDirectory(extractPath)
End Using
End Sub
End Module
Comentários
A nova entrada no arquivo contém o conteúdo do arquivo especificado por sourceFileName
. Se uma entrada com o nome especificado (entryName
) já existir no arquivo morto, uma segunda entrada será criada com um nome idêntico. A LastWriteTime propriedade da entrada é definida como a última vez que o arquivo no sistema de arquivos foi alterado.
Quando ZipArchiveMode.Update
estiver presente, o limite de tamanho de uma entrada será limitado a Int32.MaxValue. Esse limite ocorre porque o modo de atualização usa um MemoryStream internamente para permitir a busca necessária ao atualizar um arquivo morto e MemoryStream tem um máximo igual ao tamanho de um int.
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Arquiva um arquivo, compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip.
public:
[System::Runtime::CompilerServices::Extension]
static System::IO::Compression::ZipArchiveEntry ^ CreateEntryFromFile(System::IO::Compression::ZipArchive ^ destination, System::String ^ sourceFileName, System::String ^ entryName, System::IO::Compression::CompressionLevel compressionLevel);
public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel);
static member CreateEntryFromFile : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel -> System.IO.Compression.ZipArchiveEntry
<Extension()>
Public Function CreateEntryFromFile (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel) As ZipArchiveEntry
Parâmetros
- destination
- ZipArchive
O arquivo zip ao qual o arquivo será adicionado.
- sourceFileName
- String
O caminho para o arquivo a ser arquivado. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.
- entryName
- String
O nome da entrada a ser criada no arquivo zip.
- compressionLevel
- CompressionLevel
Um dos valores de enumeração que indica se é necessário enfatizar a eficiência de compactação ou velocidade ao criar a entrada.
Retornos
Um wrapper para a nova entrada no arquivo zip.
Exceções
sourceFileName
é Empty, contém somente espaços em branco ou, pelo menos, um caractere inválido.
- ou -
entryName
é Empty.
sourceFileName
ou entryName
é null
.
sourceFileName
é inválido (por exemplo, está em uma unidade não mapeada).
Em sourceFileName
, o caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.
O arquivo especificado por sourceFileName
não pode ser aberto ou é muito grande para ser atualizado (o limite atual é Int32.MaxValue).
sourceFileName
especifica um diretório.
- ou -
O chamador não tem a permissão necessária para acessar o arquivo especificado por sourceFileName
.
O arquivo especificado por sourceFileName
não foi encontrado.
O parâmetro sourceFileName
está em um formato inválido.
- ou -
O arquivo zip não dá suporte à gravação.
O arquivo zip foi descartado.
Exemplos
O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente e especificar o nível de compactação.
using System;
using System.IO;
using System.IO.Compression;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string zipPath = @"c:\users\exampleuser\start.zip";
string extractPath = @"c:\users\exampleuser\extract";
string newFile = @"c:\users\exampleuser\NewFile.txt";
using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
{
archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest);
archive.ExtractToDirectory(extractPath);
}
}
}
}
Imports System.IO
Imports System.IO.Compression
Module Module1
Sub Main()
Dim zipPath As String = "c:\users\exampleuser\end.zip"
Dim extractPath As String = "c:\users\exampleuser\extract"
Dim newFile As String = "c:\users\exampleuser\NewFile.txt"
Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
archive.ExtractToDirectory(extractPath)
End Using
End Sub
End Module
Comentários
A nova entrada no arquivo contém o conteúdo do arquivo especificado por sourceFileName
. Se uma entrada com o nome especificado (entryName
) já existir no arquivo morto, uma segunda entrada será criada com um nome idêntico. A LastWriteTime propriedade da entrada é definida como a última vez que o arquivo no sistema de arquivos foi alterado.
Quando ZipArchiveMode.Update
estiver presente, o limite de tamanho de uma entrada será limitado a Int32.MaxValue. Esse limite ocorre porque o modo de atualização usa um MemoryStream internamente para permitir a busca necessária ao atualizar um arquivo morto e MemoryStream tem um máximo igual ao tamanho de um int.
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: