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.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 gibt möglicherweise einen ungenauen Wert zurück, da Sie Native Funktionen verwendet, deren Werte nicht fortlaufend vom Betriebssystem aktualisiert werden.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äß seinen eigenen Regeln.Each operating system manages the last write time according to its own rules. Um die Leistung zu verbessern, legt ein Betriebssystem möglicherweise nicht den Wert für die letzte Schreibzeit auf die genaue Zeit des letzten Schreibvorgangs fest, sondern kann stattdessen eine genaue Näherung festlegen.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 die im path -Parameter beschriebene Datei nicht vorhanden ist, gibt diese Methode 12:00 Mitternacht, 1. Januar 1601 n. Chr. zurück.If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Koordinierte Weltzeit (UTC), angepasst an Ortszeit.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

Der path -Parameter darf relative oder absolute Pfadinformationen angeben.The path parameter is permitted to specify relative or absolute path information. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden GetCurrentDirectorySie unter.To obtain the current working directory, see GetCurrentDirectory.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine 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. Zugehörige Enumeration:ReadAssociated enumeration: Read

Gilt für:

Siehe auch