File.GetLastWriteTime Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

GetLastWriteTime(SafeFileHandle)	Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře.
GetLastWriteTime(String)	Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře.

GetLastWriteTime(SafeFileHandle)

Zdroj:

File.cs

Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře.

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 souboru nebo adresáře, pro který chcete získat informace o datu a čase posledního zápisu.

Návraty

DateTime

Struktura DateTime nastavená na datum a čas posledního zápisu pro zadaný soubor nebo adresář. Tato hodnota se vyjadřuje v místním čase.

Výjimky

ArgumentNullException

fileHandle je null.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

GetLastWriteTime(String)

Zdroj:

File.cs

Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře.

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

Soubor nebo adresář, pro který chcete získat informace o datu a čase zápisu.

Návraty

DateTime

Struktura DateTime nastavená na datum a čas posledního zápisu zadaného souboru nebo adresáře. Tato hodnota se vyjadřuje v místním čase.

Výjimky

UnauthorizedAccessException

Volající nemá požadované oprávnění.

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody GetInvalidPathChars() můžete zadat dotaz na neplatné znaky.

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad ukazuje 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

Poznámky

Poznámka

Tato metoda může vrátit nepřesnou hodnotu, protože používá nativní funkce, jejichž hodnoty nemusí být průběžně aktualizovány operačním systémem. Každý operační systém spravuje čas posledního zápisu podle vlastních pravidel. Kvůli zvýšení výkonu nemusí operační systém nastavit hodnotu času posledního zápisu na přesný čas poslední operace zápisu, ale může ji místo toho nastavit na blízkou aproximaci.

Pokud soubor popsaný v parametru path neexistuje, vrátí tato metoda 12:00 půlnoc, 1. ledna 1601 A.D. (C.E.) Koordinovaný univerzální čas (UTC) upravený na místní čas.

Parametr path má povoleno zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Aktuální pracovní adresář získáte v GetCurrentDirectory.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.

Viz také

• FileSystemWatcher
• soubor a streamování vstupně-výstupních
• čtení textu ze souboru
• Postupy: Zápis textu do souboru