Directory.GetCreationTime(String) Metoda

Definicja

Pobiera datę i godzinę utworzenia katalogu.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

Parametry

path
String

Ścieżka katalogu.The path of the directory.

Zwraca

Struktura, która jest ustawiona na datę i godzinę utworzenia określonego katalogu.A structure that is set to the creation date and time for the specified directory. Ta wartość jest wyrażona w czasie lokalnym.This value is expressed in local time.

Wyjątki

Element wywołujący nie ma wymaganego uprawnienia.The caller does not have the required permission.

path jest ciągiem o zerowej długości, zawiera tylko znak odstępu lub zawiera jeden lub więcej nieprawidłowych znaków.path is a zero-length string, contains only white space, or contains one or more invalid characters. Za pomocą metody GetInvalidPathChars() można wykonywać zapytania dotyczące nieprawidłowych znaków.You can query for invalid characters by using the GetInvalidPathChars() method.

Parametr path ma wartość null.path is null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.The specified path, file name, or both exceed the system-defined maximum length.

Przykłady

Poniższy przykład pobiera czas utworzenia określonego katalogu.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

Uwagi

Uwaga

Ta metoda może zwracać niedokładną wartość, ponieważ używa funkcji natywnych, których wartości mogą nie być stale aktualizowane przez system operacyjny.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system.

Ta metoda jest równoważna z File.GetCreationTime.This method is equivalent to File.GetCreationTime.

Jeśli katalog opisany w path parametr nie istnieje, ta metoda zwraca 12:00 północy, 1 stycznia 1601 N.E.If the directory described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. 0001 Uniwersalny czas koordynowany (UTC), dostosowany do czasu lokalnego.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej.The path parameter is permitted to specify relative or absolute path information. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego.Relative path information is interpreted as relative to the current working directory. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

W parametrze path nie jest rozróżniana wielkość liter.The path parameter is not case-sensitive.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zabezpieczenia

FileIOPermission
do odczytywania określonego pliku lub katalogu.for reading the specified file or directory. Skojarzone Wyliczenie: ReadAssociated enumeration: Read

Dotyczy

Zobacz też