DateTime.ToFileTime-Methode

Artikel
08/20/2007

Konvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function ToFileTime As Long
'Usage
Dim instance As DateTime
Dim returnValue As Long

returnValue = instance.ToFileTime

public long ToFileTime ()

public:
long long ToFileTime ()

public long ToFileTime ()

public function ToFileTime () : long

Rückgabewert

Der Wert des aktuellen DateTime-Objekts als Windows-Dateizeit.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Die resultierende Dateizeit stellt ein Datum und eine Zeit vor dem 1. Januar 1601 u. Z. 00:00 Uhr UTC dar.

Hinweise

Eine Windows-Dateizeit ist ein 64-Bit-Wert, der die Anzahl von 100-Nanosekunden-Intervallen darstellt, die seit 1. Januar 1601, 00:00 u. Z. koordinierter Weltzeit (Coordinated Universal Time, UTC) verstrichen sind. Windows verwendet eine Dateizeit, um aufzuzeichnen, wann eine Anwendung eine Datei erstellt, auf eine Datei zugreift oder in eine Datei schreibt.

Frühere Versionen der ToFileTime-Methode gehen davon aus, dass das aktuelle DateTime-Objekt eine Ortszeit angibt. Seit .NET Framework, Version 2.0, verwendet die ToFileTime-Methode die Kind-Eigenschaft, um zu bestimmen, ob das aktuelle DateTime-Objekt eine lokale Zeit, eine UTC-Zeit oder eine nicht angegebene Art von Zeit ist, die als lokale Zeit behandelt wird.

Beispiel

Im folgenden Codebeispiel wird die ToFileTime-Methode veranschaulicht.

Overloads Shared Sub Main(ByVal args() As String)

   System.Console.WriteLine("Enter the file path:")
   Dim filePath As String
   filePath = System.Console.ReadLine()

   If System.IO.File.Exists(filePath) Then
      Dim fileCreationDateTime As System.DateTime
      fileCreationDateTime = System.IO.File.GetCreationTime(filePath)

      Dim fileCreationFileTime As Long
      fileCreationFileTime = fileCreationDateTime.ToFileTime()

      System.Console.WriteLine("{0} in file time is {1}.", _
                               fileCreationDateTime, _
                               fileCreationFileTime)
   Else
      System.Console.WriteLine("{0} is an invalid file", filePath)
   End If
End Sub

static void Main(string[] args)
{
    System.Console.WriteLine("Enter the file path:");
    string filePath = System.Console.ReadLine();

    if (System.IO.File.Exists(filePath)) {
        System.DateTime fileCreationDateTime = 
            System.IO.File.GetCreationTime(filePath);

        long fileCreationFileTime = fileCreationDateTime.ToFileTime();

        System.Console.WriteLine("{0} in file time is {1}.",
                                 fileCreationDateTime,
                                 fileCreationFileTime);
    } 
    else {
        System.Console.WriteLine("{0} is an invalid file", filePath);
    }
}

int main()
{
   System::Console::WriteLine( "Enter the file path:" );
   String^ filePath = System::Console::ReadLine();
   if ( System::IO::File::Exists( filePath ) )
   {
      System::DateTime fileCreationDateTime = System::IO::File::GetCreationTime( filePath );
      __int64 fileCreationFileTime = fileCreationDateTime.ToFileTime();
      System::Console::WriteLine( "{0} in file time is {1}.", fileCreationDateTime, fileCreationFileTime );
   }
   else
   {
      System::Console::WriteLine( "{0} is an invalid file", filePath );
   }
}

public static void main(String[] args)
{
    System.Console.WriteLine("Enter the file path:");
    String filePath = System.Console.ReadLine();

    if (System.IO.File.Exists(filePath)) {
        System.DateTime fileCreationDateTime = System.IO.File.
            GetCreationTime(filePath);
        long fileCreationFileTime = fileCreationDateTime.ToFileTime();
        System.Console.WriteLine("{0} in file time is {1}.", 
        fileCreationDateTime, (Int64)fileCreationFileTime);
    }
    else {
        System.Console.WriteLine("{0} is an invalid file", filePath);
    }
} //main

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DateTime-Struktur
DateTime-Member
System-Namespace
ToFileTimeUtc
Int64
ToUniversalTime
GetUtcOffset

Freigeben über