ZipArchiveEntry.LastWriteTime Propriedade

Definição

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Assembly:

netstandard.dll

Obtém ou define a última vez que a entrada no arquivo morto zip foi alterada.

public:
 property DateTimeOffset LastWriteTime { DateTimeOffset get(); void set(DateTimeOffset value); };

public DateTimeOffset LastWriteTime { get; set; }

member this.LastWriteTime : DateTimeOffset with get, set

Public Property LastWriteTime As DateTimeOffset

Valor da propriedade

DateTimeOffset

A última vez que a entrada no arquivo morto zip foi alterada.

Exceções

NotSupportedException

A tentativa de definir essa propriedade falhou, porque o arquivo morto zip da entrada está no modo Read.

IOException

O modo de arquivo morto é definido como Create.

- ou - O modo de arquivo morto é definido como Update e a entrada foi aberta.

ArgumentOutOfRangeException

Foi feita uma tentativa de definir essa propriedade com um valor anterior a 1º de janeiro de 1980 0:00:00 (meia-noite) ou posterior a 31 de dezembro de 2107 23:59:58 (um segundo antes da meia-noite).

Comentários

Quando você cria uma nova entrada de um arquivo existente chamando o CreateEntryFromFile método, a LastWriteTime propriedade da entrada é definida automaticamente como a última vez que o arquivo foi modificado. Quando você cria uma nova entrada programaticamente chamando o CreateEntry método, a LastWriteTime propriedade da entrada é automaticamente definida como o tempo de execução. Se você modificar a entrada, deverá definir explicitamente a LastWriteTime propriedade se quiser que o valor reflita a hora da última alteração.

Quando você define essa propriedade, o DateTimeOffset valor é convertido em um formato de carimbo de data/hora específico para arquivos zip. Esse formato dá suporte a uma resolução de dois segundos. O valor mais antigo permitido é 1980 1 0:00:00 de janeiro (meia-noite). O último valor permitido é 2107 31 de dezembro 23:59:58 (um segundo antes da meia-noite). Se o valor da última gravação não for válido, a propriedade retornará um valor padrão de 1980 1 0:00:00 de janeiro (meia-noite).

Exemplos

O exemplo a seguir mostra como abrir uma entrada em um arquivo zip, modificá-la e definir a LastWriteTime propriedade como a hora atual.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\example\result.zip";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                ZipArchiveEntry entry = archive.GetEntry("ExistingFile.txt");
                using (StreamWriter writer = new StreamWriter(entry.Open()))
                {
                    writer.BaseStream.Seek(0, SeekOrigin.End);
                    writer.WriteLine("append line to file");
                }
                entry.LastWriteTime = DateTimeOffset.UtcNow.LocalDateTime;
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\example\result.zip"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            Dim entry As ZipArchiveEntry = archive.GetEntry("ExistingFile.txt")

            Using writer As StreamWriter = New StreamWriter(entry.Open())
                writer.BaseStream.Seek(0, SeekOrigin.End)
                writer.WriteLine("append line to file")
            End Using
            entry.LastWriteTime = DateTimeOffset.UtcNow.LocalDateTime
        End Using
    End Sub

End Module