File.GetLastWriteTime(String) File.GetLastWriteTime(String) File.GetLastWriteTime(String) File.GetLastWriteTime(String) Method

Definition

Gibt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis zurück.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

Parameter

path
String String String String

Die Datei oder das Verzeichnis, für die bzw. für das die Informationen über Schreibdatum und -zeitpunkt abgerufen werden sollen.The file or directory for which to obtain write date and time information.

Gibt zurück

Eine DateTime-Struktur, die auf das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis festgelegt wird.A DateTime structure set to the date and time that the specified file or directory was last written to. Dieser Wert wird in Ortszeit angegeben.This value is expressed in local time.

Ausnahmen

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

path weist ein ungültiges Format auf.path is in an invalid format.

Beispiele

Das folgende Beispiel zeigt GetLastWriteTime.The following example demonstrates 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());
        }
    }
}
Imports System
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

Hinweise

Hinweis

Diese Methode kann einen fehlerhaften Wert, zurück, da sie systemeigene Funktionen verwendet, deren Werte nicht kontinuierlich durch das Betriebssystem aktualisiert werden können.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system. Jedes Betriebssystem verwaltet den Zeitpunkt des letzten Schreibzugriffs gemäß ihren eigenen Regeln.Each operating system manages the last write time according to its own rules. Zur Verbesserung der Leistung ein Betriebssystems den letzten Schreibvorgang Uhrzeitwert möglicherweise nicht auf den genauen Zeitpunkt des letzten Schreibvorgangs festgelegt, aber möglicherweise legen Sie sie auf eine starke Annäherung stattdessen.To improve performance, an operating system might not set the last write time value to the exact time of the last write operation, but might set it to a close approximation instead.

Wenn in die Datei beschrieben die path Parameter ist nicht vorhanden, diese Methode gibt zurück, 0:00 Uhr, 1. Januar 1601 n. Chr.If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC), in die lokale Zeit angepasst.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

Die path Parameter dürfen relativer oder absoluter Pfad angegeben werden.The path parameter is permitted to specify relative or absolute path information. Relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Um das aktuelle Arbeitsverzeichnis zu erhalten, finden Sie unter GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Lesen aus der angegebenen Datei.for reading from the specified file. Zugeordnete Enumeration: ReadAssociated enumeration: Read

Gilt für:

Siehe auch