File.GetLastWriteTime Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

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

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

SafeFileHandle do pliku lub katalogu, dla którego można uzyskać informacje o ostatniej dacie i godzinie 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 jest null.

UnauthorizedAccessException

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

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 można uzyskać 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 ma wymaganych uprawnień.

ArgumentException

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().

ArgumentNullException

path jest null.

PathTooLongException

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

NotSupportedException

path jest w nieprawidłowym formacie.

Przykłady

W poniższym przykładzie pokazano GetLastWriteTime.

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

Nuta

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ż

• FileSystemWatcher
• plików i strumienia we/wy
• odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku