Directory.GetCreationTime(String) Directory.GetCreationTime(String) Directory.GetCreationTime(String) Directory.GetCreationTime(String) Method

Definition

Ruft Datum und Zeit der Erstellung eines Verzeichnisses ab.Gets the creation date and time of a directory.

public:
 static DateTime GetCreationTime(System::String ^ path);
public static DateTime GetCreationTime (string path);
static member GetCreationTime : string -> DateTime
Public Shared Function GetCreationTime (path As String) As DateTime

Parameter

path
String String String String

Der Pfad des Verzeichnisses.The path of the directory.

Gibt zurück

Eine Struktur, die auf das Erstellungsdatum und den Erstellungszeitpunkt für das angegebene Verzeichnis festgelegt wird.A structure that is set to the creation date and time for the specified directory. 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 enthält mindestens ein ungültiges Zeichen.path is a zero-length string, contains only white space, or contains one or more invalid characters. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.You can query for invalid characters by using the GetInvalidPathChars() method.

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.

Beispiele

Im folgenden Beispiel wird die Erstellungszeit des angegebenen Verzeichnisses abgerufen.The following example gets the creation time of the specified directory.

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      
      // Get the creation time of a well-known directory.
      DateTime dt = Directory::GetCreationTime( Environment::CurrentDirectory );
      
      // Give feedback to the user.
      if ( DateTime::Now.Subtract( dt ).TotalDays > 364 )
      {
         Console::WriteLine( "This directory is over a year old." );
      }
      else
      if ( DateTime::Now.Subtract( dt ).TotalDays > 30 )
      {
         Console::WriteLine( "This directory is over a month old." );
      }
      else
      if ( DateTime::Now.Subtract( dt ).TotalDays <= 1 )
      {
         Console::WriteLine( "This directory is less than a day old." );
      }
      else
      {
         Console::WriteLine( "This directory was created on {0}", dt );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }

}

using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        try 
        {
            // Get the creation time of a well-known directory.
            DateTime dt = Directory.GetCreationTime(Environment.CurrentDirectory);

            // Give feedback to the user.
            if (DateTime.Now.Subtract(dt).TotalDays > 364) 
            {
                Console.WriteLine("This directory is over a year old.");
            } 
            else if (DateTime.Now.Subtract(dt).TotalDays > 30) 
            {
                Console.WriteLine("This directory is over a month old.");
            } 
            else if (DateTime.Now.Subtract(dt).TotalDays <= 1) 
            {
                Console.WriteLine("This directory is less than a day old.");
            } 
            else 
            {
                Console.WriteLine("This directory was created on {0}", dt);
            }
        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}
Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Try
            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = Directory.GetCreationTime(Environment.CurrentDirectory)

            ' Give feedback to the user.
            If DateTime.Now.Subtract(dt).TotalDays > 364 Then
                Console.WriteLine("This directory is over a year old.")
            ElseIf DateTime.Now.Subtract(dt).TotalDays > 30 Then
                Console.WriteLine("This directory is over a month old.")
            ElseIf DateTime.Now.Subtract(dt).TotalDays <= 1 Then
                Console.WriteLine("This directory is less than a day old.")
            Else
                Console.WriteLine("This directory was created on {0}", dt)
            End If

        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.

Diese Methode entspricht File.GetCreationTime.This method is equivalent to File.GetCreationTime.

Wenn das im path -Parameter beschriebene Verzeichnis nicht vorhanden ist, gibt diese Methode 12:00 Mitternacht, 1. Januar 1601 n. Chr. zurück.If the directory 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.

Der path -Parameter berücksichtigt nicht die Groß-/Kleinschreibung.The path parameter is not case-sensitive.

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 der angegebenen Datei bzw. des angegebenen Verzeichnisses.for reading the specified file or directory. Zugehörige Enumeration:ReadAssociated enumeration: Read

Gilt für:

Siehe auch