DateTimeOffset.FromFileTime(Int64) Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTimeOffset.cs

Konvertiert die angegebene Windows-Dateizeit in eine entsprechende lokale Uhrzeit.

C#

public static DateTimeOffset FromFileTime(long fileTime);

Parameter

fileTime

Int64

Eine Windows-Dateizeit, ausgedrückt in Teilstrichen.

Gibt zurück

DateTimeOffset

Ein Objekt, das das Datum und die Uhrzeit fileTime darstellt, wobei der Offset auf den Lokalen Zeitoffset festgelegt ist.

Ausnahmen

ArgumentOutOfRangeException

fileTime ist kleiner als Null.

-oder-

fileTime ist größer als DateTimeOffset.MaxValue.Ticks.

Beispiele

Im folgenden Beispiel wird die Windows-API zum Abrufen der Windows-Dateizeiten für die ausführbare Datei von WordPad verwendet.

C#

using System;
using System.IO;
using System.Runtime.InteropServices;

public struct FileTime
{
   public uint dwLowDateTime;
   public uint dwHighDateTime;

   public static implicit operator long(FileTime fileTime)
   {
      long returnedLong;
      // Convert 4 high-order bytes to a byte array
      byte[] highBytes = BitConverter.GetBytes(fileTime.dwHighDateTime);
      // Resize the array to 8 bytes (for a Long)
      Array.Resize(ref highBytes, 8);

      // Assign high-order bytes to first 4 bytes of Long
      returnedLong = BitConverter.ToInt64(highBytes, 0);
      // Shift high-order bytes into position
      returnedLong = returnedLong << 32;
      // Or with low-order bytes
      returnedLong = returnedLong | fileTime.dwLowDateTime;
      // Return long
      return returnedLong;
   }
}

public class FileTimes
{
   private const int OPEN_EXISTING = 3;
   private const int INVALID_HANDLE_VALUE = -1;

   [DllImport("Kernel32.dll", CharSet = CharSet.Unicode)]
   private static extern int CreateFile(string lpFileName,
                                       int dwDesiredAccess,
                                       int dwShareMode,
                                       int lpSecurityAttributes,
                                       int dwCreationDisposition,
                                       int dwFlagsAndAttributes,
                                       int hTemplateFile);

   [DllImport("Kernel32.dll")]
   private static extern bool GetFileTime(int hFile,
                                          out FileTime lpCreationTime,
                                          out FileTime lpLastAccessTime,
                                          out FileTime lpLastWriteTime);

   [DllImport("Kernel32.dll")]
   private static extern bool CloseHandle(int hFile);

   public static void Main()
   {
      // Open file %windir%\write.exe
      string winDir = Environment.SystemDirectory;
      if (!(winDir.EndsWith(Path.DirectorySeparatorChar.ToString())))
         winDir += Path.DirectorySeparatorChar;
      winDir += "write.exe";

      // Get file time using Windows API
      //
      // Open file
      int hFile = CreateFile(winDir, 0, 0, 0, OPEN_EXISTING, 0, 0);
      if (hFile == INVALID_HANDLE_VALUE)
      {
         Console.WriteLine("Unable to access {0}.", winDir);
      }
      else
      {
         FileTime creationTime, accessTime, writeTime;
         if (GetFileTime(hFile, out creationTime, out accessTime, out writeTime))
         {
            CloseHandle(hFile);
            long fileCreationTime = (long) creationTime;
            long fileAccessTime = accessTime;
            long fileWriteTime = (long) writeTime;

            Console.WriteLine("File {0} Retrieved Using the Windows API:", winDir);
            Console.WriteLine("   Created:     {0:d}", DateTimeOffset.FromFileTime(fileCreationTime).ToString());
            Console.WriteLine("   Last Access: {0:d}", DateTimeOffset.FromFileTime(fileAccessTime).ToString());
            Console.WriteLine("   Last Write:  {0:d}", DateTimeOffset.FromFileTime(fileWriteTime).ToString());
            Console.WriteLine();
         }
      }

      // Get date and time, convert to file time, then convert back
      FileInfo fileInfo = new FileInfo(winDir);
      DateTimeOffset infoCreationTime, infoAccessTime, infoWriteTime;
      long ftCreationTime, ftAccessTime, ftWriteTime;

      // Get dates and times of file creation, last access, and last write
      infoCreationTime = fileInfo.CreationTime;
      infoAccessTime = fileInfo.LastAccessTime;
      infoWriteTime = fileInfo.LastWriteTime;
      // Convert values to file times
      ftCreationTime = infoCreationTime.ToFileTime();
      ftAccessTime = infoAccessTime.ToFileTime();
      ftWriteTime = infoWriteTime.ToFileTime();

      // Convert file times back to DateTimeOffset values
      Console.WriteLine("File {0} Retrieved Using a FileInfo Object:", winDir);
      Console.WriteLine("   Created:     {0:d}", DateTimeOffset.FromFileTime(ftCreationTime).ToString());
      Console.WriteLine("   Last Access: {0:d}", DateTimeOffset.FromFileTime(ftAccessTime).ToString());
      Console.WriteLine("   Last Write:  {0:d}", DateTimeOffset.FromFileTime(ftWriteTime).ToString());
   }
}
// The example produces the following output:
//    File C:\WINDOWS\system32\write.exe Retrieved Using the Windows API:
//       Created:     10/13/2005 5:26:59 PM -07:00
//       Last Access: 3/20/2007 2:07:00 AM -07:00
//       Last Write:  8/4/2004 5:00:00 AM -07:00
//
//    File C:\WINDOWS\system32\write.exe Retrieved Using a FileInfo Object:
//       Created:     10/13/2005 5:26:59 PM -07:00
//       Last Access: 3/20/2007 2:07:00 AM -07:00
//       Last Write:  8/4/2004 5:00:00 AM -07:00

Hinweise

Eine Windows-Dateizeit ist ein 64-Bit-Wert, der die Anzahl von 100-Nanosekundenintervallen darstellt, die seit 12:00 Mitternacht, dem 1. Januar 1601 A.D. (C.E.) verstrichen sind. Koordinierte Weltzeit (UTC). Windows verwendet eine Dateizeit, um aufzuzeichnen, wenn eine Anwendung erstellt, auf eine Datei zugreift oder in eine Datei schreibt.

Auf eine Windows-Dateizeit kann direkt über die Windows-API zugegriffen werden, indem die GetFileTime-Funktion aufgerufen wird, die eine FILETIME Struktur zurückgibt. Der Einzelne Funktionsparameter ist das Handle der Datei, deren Dateizeitinformationen abgerufen werden sollen. Das Dateihandle wird durch Aufrufen der CreateFile-Funktion abgerufen. Das dwHighDateTime Element der FILETIME Struktur enthält die vier Byte mit hoher Reihenfolge der Dateizeit, und das dwLowDateTime Element enthält die vier Bytes mit niedriger Reihenfolge. Das folgende Beispiel veranschaulicht, wie Windows-Dateizeitwerte abgerufen und in DateTimeOffset Werte konvertiert werden.

Windows-Dateizeitwerte können auch aus DateTime Werten erstellt werden, indem sie die Methoden DateTime.ToFileTime und DateTime.ToFileTimeUtc aufrufen, und aus DateTimeOffset Werten durch Aufrufen der DateTimeOffset.ToFileTime-Methode.

Gilt für: