本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

Directory.SetLastWriteTimeUtc 方法 (String, DateTime)

 

设置上次写入某个目录的日期和时间,其格式为协调通用时 (UTC)。

命名空间:   System.IO
程序集:  mscorlib(位于 mscorlib.dll)

public static void SetLastWriteTimeUtc(
	string path,
	DateTime lastWriteTimeUtc
)

参数

path
Type: System.String

目录的路径。

lastWriteTimeUtc
Type: System.DateTime

上次写入目录的日期和时间。 该值用 UTC 时间表示。

Exception Condition
FileNotFoundException

未找到指定路径。

ArgumentException

path 为长度为零的字符串,仅包含空格,或包含一个或多个无效字符。 你可以使用 GetInvalidPathChars 方法查询无效字符。

ArgumentNullException

pathnull

PathTooLongException

指定的路径和/或文件名超过了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须少于 248 个字符,且文件名必须少于 260 个字符。

UnauthorizedAccessException

调用方没有所要求的权限。

PlatformNotSupportedException

当前操作系统不是 Windows NT 或更高版本。

ArgumentOutOfRangeException

lastWriteTimeUtc 指定的值超出了该操作所允许的日期或时间范围。

path 参数允许指定相对或绝对路径信息。 相对路径信息被解释为相对于当前工作目录。 若要获取当前工作目录,请参阅 GetCurrentDirectory

path 参数不区分大小写。

通用 I/O 任务的列表,请参阅 通用 I/O 任务

Win95Win98Win98Se

These operating systems do not support this method.

使用协调世界时 (UTC) 输出时,下面的示例说明了在输出中的差异。

// This sample shows the differences between dates from methods that use
//coordinated universal time (UTC) format and those that do not.
using System;
using System.IO;

namespace IOSamples
{
  public class DirectoryUTCTime
  {
    public static void Main()
    {
	// Set the directory.
      string n = @"C:\test\newdir";
		//Create two variables to use to set the time.
	  DateTime dtime1 = new DateTime(2002, 1, 3);
	  DateTime dtime2 = new DateTime(1999, 1, 1);

	//Create the directory.
	  try
	  {
		  Directory.CreateDirectory(n);
	  }
	  catch (IOException e)
	  {
		  Console.WriteLine(e);
	  }

	//Set the creation and last access times to a variable DateTime value.
	  Directory.SetCreationTime(n, dtime1);
	  Directory.SetLastAccessTimeUtc(n, dtime1);

		// Print to console the results.
	  Console.WriteLine("Creation Date: {0}", Directory.GetCreationTime(n));
	  Console.WriteLine("UTC creation Date: {0}", Directory.GetCreationTimeUtc(n));
	  Console.WriteLine("Last write time: {0}", Directory.GetLastWriteTime(n));
	  Console.WriteLine("UTC last write time: {0}", Directory.GetLastWriteTimeUtc(n));
	  Console.WriteLine("Last access time: {0}", Directory.GetLastAccessTime(n));
	  Console.WriteLine("UTC last access time: {0}", Directory.GetLastAccessTimeUtc(n));

		//Set the last write time to a different value.
      Directory.SetLastWriteTimeUtc(n, dtime2);
	  Console.WriteLine("Changed last write time: {0}", Directory.GetLastWriteTimeUtc(n));
    }
  }
}
// Obviously, since this sample deals with dates and times, the output will vary
// depending on when you run the executable. Here is one example of the output:
//Creation Date: 1/3/2002 12:00:00 AM
//UTC creation Date: 1/3/2002 8:00:00 AM
//Last write time: 12/31/1998 4:00:00 PM
//UTC last write time: 1/1/1999 12:00:00 AM
//Last access time: 1/2/2002 4:00:00 PM
//UTC last access time: 1/3/2002 12:00:00 AM
//Changed last write time: 1/1/1999 12:00:00 AM

FileIOPermission

for writing to the specified file or directory. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Write

通用 Windows 平台
自 10 起可用
.NET Framework
自 1.1 起可用
返回页首
显示: