File.GetLastWriteTime Metoda

Definicja

Przeciążenia

GetLastWriteTime(SafeFileHandle)

Zwraca ostatnią datę i godzinę zapisu określonego pliku lub katalogu.

GetLastWriteTime(String)

Zwraca datę i godzinę ostatniego zapisania określonego pliku lub katalogu.

GetLastWriteTime(SafeFileHandle)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Zwraca ostatnią datę i godzinę zapisu określonego pliku lub katalogu.

public static DateTime GetLastWriteTime(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

Parametry

fileHandle
SafeFileHandle

SafeFileHandle do pliku lub katalogu, dla którego można uzyskać informacje o ostatniej dacie i godzinie zapisu.

Zwraca

Struktura DateTime ustawiona na datę i godzinę ostatniego zapisu dla określonego pliku lub katalogu. Ta wartość jest wyrażona w czasie lokalnym.

Wyjątki

fileHandle jest null.

Obiekt wywołujący nie ma wymaganych uprawnień.

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.NET 7, 8, 9, 10

GetLastWriteTime(String)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Zwraca datę i godzinę ostatniego zapisania określonego pliku lub katalogu.

public static DateTime GetLastWriteTime(string path);

Parametry

path
String

Plik lub katalog, dla którego można uzyskać informacje o dacie i godzinie zapisu.

Zwraca

Struktura DateTime ustawiona na datę i godzinę ostatniego zapisania określonego pliku lub katalogu. Ta wartość jest wyrażona w czasie lokalnym.

Wyjątki

Obiekt wywołujący nie ma wymaganych uprawnień.

Wersje .NET Framework i .NET Core starsze niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera co najmniej jeden nieprawidłowy znak. Zapytanie o nieprawidłowe znaki można wykonać przy użyciu metody GetInvalidPathChars().

path jest null.

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

path jest w nieprawidłowym formacie.

Przykłady

W poniższym przykładzie pokazano GetLastWriteTime.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            string path = @"c:\Temp\MyTest.txt";
            if (!File.Exists(path))
            {
                File.Create(path);
            }
            else
            {
                // Take an action that will affect the write time.
                File.SetLastWriteTime(path, new DateTime(1985,4,3));
            }

            // Get the creation time of a well-known directory.
            DateTime dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
            
            // Update the last write time.
            File.SetLastWriteTime(path, DateTime.Now);
            dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
        }

        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Uwagi

Uwaga

Ta metoda może zwrócić niedokładną wartość, ponieważ używa funkcji natywnych, których wartości mogą nie być stale aktualizowane przez system operacyjny. Każdy system operacyjny zarządza ostatnim czasem zapisu zgodnie z własnymi regułami. Aby zwiększyć wydajność, system operacyjny może nie ustawić wartości czasu ostatniego zapisu na dokładny czas ostatniej operacji zapisu, ale może ustawić go na bliskie przybliżenie.

Jeśli plik opisany w parametrze path nie istnieje, ta metoda zwraca 12:00 północy, 1 stycznia 1601 R. (C.E.) Uniwersalny czas koordynowany (UTC), dostosowany do czasu lokalnego.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.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, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 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