File.SetLastWriteTime Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

SetLastWriteTime(SafeFileHandle, DateTime)	Nastaví datum a čas, do kterého byl zadaný soubor nebo adresář naposledy zapsán.
SetLastWriteTime(String, DateTime)	Nastaví datum a čas posledního zápisu zadaného souboru.

SetLastWriteTime(SafeFileHandle, DateTime)

Zdroj:

File.cs

Nastaví datum a čas, do kterého byl zadaný soubor nebo adresář naposledy zapsán.

public:
 static void SetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastWriteTime);

public static void SetLastWriteTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastWriteTime);

static member SetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetLastWriteTime (fileHandle As SafeFileHandle, lastWriteTime As DateTime)

Parametry

fileHandle

SafeFileHandle

Do SafeFileHandle souboru nebo adresáře, pro který chcete nastavit datum a čas posledního zápisu.

lastWriteTime

DateTime

Obsahující DateTime hodnotu, která se má nastavit pro datum a čas posledního zápisu pro fileHandle. Tato hodnota je vyjádřena v místním čase.

Výjimky

ArgumentNullException

fileHandle je null.

ArgumentOutOfRangeException

lastWriteTime určuje hodnotu mimo rozsah kalendářních dat, časů nebo obou povolených pro tuto operaci.

UnauthorizedAccessException

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

IOException

Při provádění operace došlo k vstupně-výstupní chybě.

SetLastWriteTime(String, DateTime)

Zdroj:

File.cs

Nastaví datum a čas posledního zápisu zadaného souboru.

public:
 static void SetLastWriteTime(System::String ^ path, DateTime lastWriteTime);

public static void SetLastWriteTime (string path, DateTime lastWriteTime);

static member SetLastWriteTime : string * DateTime -> unit

Public Shared Sub SetLastWriteTime (path As String, lastWriteTime As DateTime)

Parametry

path

String

Soubor, pro který chcete nastavit informace o datu a čase.

lastWriteTime

DateTime

Obsahující DateTime hodnotu, která se má nastavit pro datum a čas posledního zápisu pro path. Tato hodnota je vyjádřena v místním čase.

Výjimky

ArgumentException

.NET Framework a .NET Core verze 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ů. Na neplatné znaky se můžete dotazovat pomocí metody .GetInvalidPathChars()

ArgumentNullException

path je null.

PathTooLongException

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

FileNotFoundException

Zadaná cesta nebyla nalezena.

UnauthorizedAccessException

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

NotSupportedException

path je v neplatném formátu.

ArgumentOutOfRangeException

lastWriteTime určuje hodnotu mimo rozsah kalendářních dat nebo časů povolených pro tuto operaci.

Příklady

Následující příklad zkontroluje v systému souborů zadaný soubor a v případě potřeby soubor vytvoří a pak nastaví a získá čas posledního zápisu souboru.

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

try
    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 dt = File.GetLastWriteTime path
    printfn $"The last write time for this file was {dt}."
with
| e -> printfn $"The process failed: {e}"

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 an 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

Parametr path může zadat relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Pokud chcete získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory.

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

Viz také

• FileSystemWatcher
• Vstupně-výstupní operace souborů a Stream
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru