File.GetLastWriteTime Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

GetLastWriteTime(String)	Zwraca datę i godzinę ostatniego zapisania określonego pliku lub katalogu.
GetLastWriteTime(SafeFileHandle)	Zwraca ostatnią datę i godzinę zapisu określonego pliku lub katalogu.

GetLastWriteTime(String)

Źródło:

File.cs

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

public:
 static DateTime GetLastWriteTime(System::String ^ path);

public static DateTime GetLastWriteTime (string path);

static member GetLastWriteTime : string -> DateTime

Public Shared Function GetLastWriteTime (path As String) As DateTime

Parametry

path

String

Plik lub katalog, dla którego mają być uzyskiwane informacje o dacie i godzinie zapisu.

Zwraca

DateTime

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

Wyjątki

UnauthorizedAccessException

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

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały znak lub zawiera co najmniej jeden nieprawidłowy znak. Zapytania dotyczące nieprawidłowych znaków można wykonać przy użyciu GetInvalidPathChars() metody .

ArgumentNullException

path to null.

PathTooLongException

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

NotSupportedException

path jest w nieprawidłowym formacie.

Przykłady

W poniższym przykładzie pokazano GetLastWriteTimeelement .

using namespace System;
using namespace System::IO;
int 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, 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 );
   }

}

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());
        }
    }
}

open System
open System.IO

let path = @"c:\Temp\MyTest.txt"

if File.Exists path |> not then
    File.Create path |> ignore
else
    // Take an action that will affect the write time.
    File.SetLastWriteTime(path, DateTime(1985, 4, 3))

// Get the creation time of a well-known directory.
let dt = File.GetLastWriteTime path
printfn $"The last write time for this file was {dt}."

// Update the last write time.
File.SetLastWriteTime(path, DateTime.Now)
let dt2 = File.GetLastWriteTime path
printfn $"The last write time for this file was {dt2}."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Try
            Dim path As String = "c:\Temp\MyTest.txt"
            If File.Exists(path) = False Then
                File.Create(path)
            Else
                ' Take some action that will affect the write time.
                File.SetLastWriteTime(path, New DateTime(1985, 4, 3))
            End If

            'Get the creation time of a well-known directory.
            Dim dt As DateTime = 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 e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

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 zamiast tego może ustawić ją na bliskie przybliżenie.

Jeśli plik opisany w parametrze path nie istnieje, ta metoda zwraca 12:00 północy, 1 stycznia 1601 A.D. (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ędne w stosunku do 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ż

• FileSystemWatcher
• We/wy plików i Stream
• Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku

GetLastWriteTime(SafeFileHandle)

Ź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);

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

static member GetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetLastWriteTime (fileHandle As SafeFileHandle) As DateTime

Parametry

fileHandle

SafeFileHandle

Do SafeFileHandle pliku lub katalogu, dla którego mają być uzyskiwane informacje o dacie i godzinie ostatniego zapisu.

Zwraca

DateTime

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

ArgumentNullException

fileHandle to null.

UnauthorizedAccessException

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