Directory.GetLastWriteTime(String) Metoda

Definicja

Zwraca datę i godzinę ostatniego zapisu określonego pliku lub katalogu.Returns the date and time the specified file or directory was last written to.

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ą zostać uzyskane modyfikacje informacje o dacie i godzinie.The file or directory for which to obtain modification date and time information.

Zwraca

Struktura, która jest ustawiona na datę i godzinę ostatniego zapisu określonego pliku lub katalogu.A structure that is set to the date and time the specified file or directory was last written to. Ta wartość jest wyrażona w czasie lokalnym.This value is expressed in local time.

Wyjątki

Element wywołujący nie ma wymaganego uprawnienia.The caller does not have the required permission.

path jest ciągiem o zerowej długości, zawiera tylko znak odstępu lub zawiera jeden lub więcej nieprawidłowych znaków.path is a zero-length string, contains only white space, or contains one or more invalid characters. Za pomocą metody GetInvalidPathChars() można wykonywać zapytania dotyczące nieprawidłowych znaków.You can query for invalid characters with the GetInvalidPathChars() method.

Parametr path ma wartość null.path is null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.The specified path, file name, or both exceed the system-defined maximum length.

Przykłady

Poniższy przykład ilustruje sposób używania GetLastWriteTime.The following example demonstrates how to use GetLastWriteTime.

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      String^ path = "c:\\MyDir";
      if (  !Directory::Exists( path ) )
      {
         Directory::CreateDirectory( path );
      }
      else
      {
         
         // Take an action which will affect the write time.
         Directory::SetLastWriteTime( path, DateTime(1985,4,3) );
      }
      
      // Get the creation time of a well-known directory.
      DateTime dt = Directory::GetLastWriteTime( path );
      Console::WriteLine( "The last write time for this directory was {0}", dt );
      
      // Update the last write time.
      Directory::SetLastWriteTime( path, DateTime::Now );
      dt = Directory::GetLastWriteTime( path );
      Console::WriteLine( "The last write time for this directory 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:\MyDir";
            if (!Directory.Exists(path)) 
            {
                Directory.CreateDirectory(path);
            } 
            else 
            {
                // Take an action which will affect the write time.
                Directory.SetLastWriteTime(path, new DateTime(1985,4,3));
            }

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

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

Public Class Test
    Public Shared Sub Main()
        Try
            Dim path As String = "c:\MyDir"
            If Directory.Exists(path) = False Then
                Directory.CreateDirectory(path)
            Else
                ' Take an action which will affect the write time.
                Directory.SetLastWriteTime(path, New DateTime(1985, 4, 3))
            End If

            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = Directory.GetLastWriteTime(path)
            Console.WriteLine("The last write time for this directory was {0}", dt)

            ' Update the last write time.
            Directory.SetLastWriteTime(path, DateTime.Now)
            dt = Directory.GetLastWriteTime(path)
            Console.WriteLine("The last write time for this directory 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 zwracać niedokładną wartość, ponieważ używa funkcji natywnych, których wartości mogą nie być stale aktualizowane przez system operacyjny.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system.

Jeśli katalog opisany w path parametr nie istnieje, ta metoda zwraca 12:00 północy, 1 stycznia 1601 N.E.If the directory described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. 0001 Uniwersalny czas koordynowany (UTC), dostosowany do czasu lokalnego.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej.The path parameter is permitted to specify relative or absolute path information. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego.Relative path information is interpreted as relative to the current working directory. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

W parametrze path nie jest rozróżniana wielkość liter.The path parameter is not case-sensitive.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zabezpieczenia

FileIOPermission
do odczytywania określonego pliku lub katalogu.for reading the specified file or directory. Skojarzone Wyliczenie: ReadAssociated enumeration: Read

Dotyczy

Zobacz też