Directory Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет статические методы для создания, перемещения и перечисления в каталогах и вложенных каталогах. Этот класс не наследуется.
public ref class Directory abstract sealed
public ref class Directory sealed
public static class Directory
public sealed class Directory
[System.Runtime.InteropServices.ComVisible(true)]
public static class Directory
type Directory = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type Directory = class
Public Class Directory
Public NotInheritable Class Directory
- Наследование
-
Directory
- Атрибуты
В следующем примере показано, как получить все текстовые файлы из каталога и переместить их в новый каталог. После перемещения файлов они больше не существуют в исходном каталоге.
using System;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string sourceDirectory = @"C:\current";
string archiveDirectory = @"C:\archive";
try
{
var txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt");
foreach (string currentFile in txtFiles)
{
string fileName = currentFile.Substring(sourceDirectory.Length + 1);
Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName));
}
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
}
open System.IO
let sourceDirectory = @"C:\current"
let archiveDirectory = @"C:\archive"
try
let txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt")
for currentFile in txtFiles do
let fileName = currentFile.Substring(sourceDirectory.Length + 1)
Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName))
with e ->
printfn $"{e.Message}"
Imports System.IO
Module Module1
Sub Main()
Dim sourceDirectory As String = "C:\current"
Dim archiveDirectory As String = "C:\archive"
Try
Dim txtFiles = Directory.EnumerateFiles(sourceDirectory, "*.txt")
For Each currentFile As String In txtFiles
Dim fileName = currentFile.Substring(sourceDirectory.Length + 1)
Directory.Move(currentFile, Path.Combine(archiveDirectory, fileName))
Next
Catch e As Exception
Console.WriteLine(e.Message)
End Try
End Sub
End Module
В следующем примере показано, как использовать EnumerateFiles метод для получения коллекции текстовых файлов из каталога, а затем использовать ее в запросе для поиска всех строк, содержащих "Example".
using System;
using System.IO;
using System.Linq;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string archiveDirectory = @"C:\archive";
var files = from retrievedFile in Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories)
from line in File.ReadLines(retrievedFile)
where line.Contains("Example")
select new
{
File = retrievedFile,
Line = line
};
foreach (var f in files)
{
Console.WriteLine("{0} contains {1}", f.File, f.Line);
}
Console.WriteLine("{0} lines found.", files.Count().ToString());
}
}
}
open System.IO
let archiveDirectory = @"C:\archive"
let files =
query {
for retrivedFile in Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories) do
for line in File.ReadLines retrivedFile do
where (line.Contains "file")
select
{| File = retrivedFile
Line = line |}
}
for f in files do
printfn $"{f.File} contains {f.Line}"
printfn "{Seq.length files} lines found."
Imports System.IO
Module Module1
Sub Main()
Dim archiveDirectory As String = "C:\archive"
Dim files = From retrievedFile In Directory.EnumerateFiles(archiveDirectory, "*.txt", SearchOption.AllDirectories)
From line In File.ReadLines(retrievedFile)
Where line.Contains("Example")
Select New With {.curFile = retrievedFile, .curLine = line}
For Each f In files
Console.WriteLine("{0} contains {1}", f.curFile, f.curLine)
Next
Console.WriteLine("{0} lines found.", files.Count.ToString())
End Sub
End Module
В следующем примере показано, как переместить каталог и все его файлы в новый каталог. Исходный каталог больше не существует после его перемещения.
using System;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string sourceDirectory = @"C:\source";
string destinationDirectory = @"C:\destination";
try
{
Directory.Move(sourceDirectory, destinationDirectory);
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
}
open System.IO
let sourceDirectory = @"C:\source"
let destinationDirectory = @"C:\destination"
try
Directory.Move(sourceDirectory, destinationDirectory)
with e ->
printfn $"{e.Message}"
Imports System.IO
Module Module1
Sub Main()
Dim sourceDirectory As String = "C:\source"
Dim destinationDirectory As String = "C:\destination"
Try
Directory.Move(sourceDirectory, destinationDirectory)
Catch e As Exception
Console.WriteLine(e.Message)
End Try
End Sub
End Module
Directory Используйте класс для типичных операций, таких как копирование, перемещение, переименование, создание и удаление каталогов.
Чтобы создать каталог, используйте один из CreateDirectory методов .
Чтобы удалить каталог, используйте один из Delete методов .
Чтобы получить или задать текущий каталог для приложения, используйте GetCurrentDirectory метод или SetCurrentDirectory .
Для управления DateTime информацией, связанной с созданием, доступом и записью каталога, используйте такие методы, как SetLastAccessTime и SetCreationTime.
Статические методы Directory класса выполняют проверки безопасности для всех методов. Если вы собираетесь повторно использовать объект несколько раз, рассмотрите возможность использования соответствующего метода экземпляра DirectoryInfo , так как проверка безопасности не всегда будет необходимо.
Если выполняется только одно действие, связанное с каталогом, может быть эффективнее использовать статический Directory метод, а не соответствующий DirectoryInfo метод экземпляра. Для большинства Directory методов требуется путь к каталогу, которым вы управляете.
Примечание
В членах, которые принимают строковый path
параметр, этот путь должен быть правильно сформирован или возникает исключение. Например, если путь является полным, но начинается с пробела (" c:\temp"), строка пути не обрезается, поэтому путь считается неправильным и создается исключение. Кроме того, путь или сочетание путей не могут быть полностью заданы дважды. Например, "c:\temp c:\windows" также вызывает исключение. Убедитесь, что пути правильно сформированы при использовании методов, которые принимают строку пути. Дополнительные сведения см. в разделе Path.
В элементах, которые принимают путь, путь может ссылаться на файл или каталог. Вы можете использовать полный путь, относительный путь или UNC-путь для имени сервера и общей папки. Например, допустимы все следующие пути:
"c:\\MyDir" в C# или "c:\MyDir" в Visual Basic.
"MyDir\\MySubdir" в C# или "MyDir\MySubDir" в Visual Basic.
"\\\\MyServer\\MyShare" в C# или "\\MyServer\MyShare" в Visual Basic.
По умолчанию полный доступ на чтение и запись к новым каталогам предоставляется всем пользователям. Однако для доступа к существующим каталогам приложение должно иметь правильную безопасность.
Чтобы затребовать разрешения для каталога и всех его подкаталогов, завершите строку пути символом разделителя каталогов. (Например, "C:\Temp\" предоставляет доступ к C:\Temp\ и всем его подкаталогам.) Чтобы запрашивать разрешения только для определенного каталога, завершите строку пути точкой. (Например, "C:\Temp\"." предоставляет доступ только к C:\Temp\, а не к его подкаталогам.)
В элементах, которые принимают searchPattern
параметр, строка поиска может быть любым сочетанием литеральных символов и двух подстановочных знаков: * и ?. Этот параметр не распознает регулярные выражения. Дополнительные сведения см. в описании EnumerateDirectories(String, String) метода или любого другого метода, использующего searchPattern
параметр .
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
Directory и DirectoryInfo не поддерживаются для использования в приложениях Магазина Windows. Сведения о доступе к файлам и папкам в приложениях Магазина Windows см. в статье Доступ к данным и файлам (приложения Магазина Windows).
Create |
Создает все каталоги и подкаталоги по указанному пути, если они еще не существуют. |
Create |
Создает все каталоги по указанному пути, если они еще не существуют, с применением заданных параметров безопасности Windows. |
Create |
Создает все каталоги и подкаталоги по указанному пути с указанными разрешениями, если они уже не существуют. |
Create |
Создает символьную ссылку каталога, определяемую с помощью |
Create |
Создает пустой каталог с уникальным именем во временном каталоге текущего пользователя. |
Delete(String) |
Удаляет пустой каталог по заданному пути. |
Delete(String, Boolean) |
Удаляет заданный каталог и, при наличии соответствующей инструкции, все подкаталоги и файлы в нем. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен каталогов, расположенных по указанному пути. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен каталогов, соответствующих шаблону поиска по указанному пути. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен каталогов, соответствующих шаблону поиска по указанному пути. Возможно, поиск ведется также и в подкаталогах. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен каталогов, соответствующих шаблону поиска по указанному пути. Возможно, поиск ведется также и в подкаталогах. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен файлов, расположенных по указанному пути. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен файлов, соответствующих шаблону поиска по указанному пути. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен файлов, соответствующих шаблону поиска и параметрам перечисления по указанному пути. Возможно, поиск ведется также и в подкаталогах. |
Enumerate |
Возвращает перечисляемую коллекцию полных имен файлов, соответствующих шаблону поиска по указанному пути. Возможно, поиск ведется также и в подкаталогах. |
Enumerate |
Возвращает перечисляемую коллекцию имен файлов и имен каталогов по указанному пути. |
Enumerate |
Возвращает перечисляемую коллекцию имен файлов и имен каталогов по указанному пути, соответствующих шаблону поиска. |
Enumerate |
Возвращает перечисляемую коллекцию имен файлов и имен каталогов по указанному пути, соответствующих шаблону поиска и параметрам перечисления. |
Enumerate |
Возвращает перечисляемую коллекцию записей файловой системы, соответствующих шаблону поиска по указанному пути. Возможно, поиск ведется также и в подкаталогах. |
Exists(String) |
Определяет, указывает ли заданный путь на существующий каталог на диске. |
Get |
Получает объект DirectorySecurity, который инкапсулирует записи списка управления доступом (ACL) для заданного каталога. |
Get |
Получает объект DirectorySecurity, который инкапсулирует записи списка управления доступом (ACL) указанного типа для заданного каталога. |
Get |
Получает дату и время создания каталога. |
Get |
Получает время и дату создания каталога в формате всемирного координированного времени (UTC). |
Get |
Получает текущий рабочий каталог приложения. |
Get |
Возвращает имена подкаталогов (включая пути) в указанном каталоге. |
Get |
Возвращает имена подкаталогов (включая пути) в указанном каталоге, соответствующих указанному шаблону поиска. |
Get |
Возвращает имена подкаталогов (включая пути) в указанном каталоге, соответствующих заданному шаблону поиска и параметрам перечисления. |
Get |
Возвращает имена подкаталогов (включая пути) в указанном каталоге, соответствующих указанному шаблону поиска, и при необходимости ведет поиск в подкаталогах. |
Get |
Возвращает для заданного пути сведения о томе и корневом каталоге по отдельности или сразу. |
Get |
Возвращает имена файлов (с указанием пути к ним) в указанном каталоге. |
Get |
Возвращает имена файлов (включая пути) из указанного каталога, отвечающие условиям заданного шаблона поиска. |
Get |
Возвращает имена файлов (включая пути) в указанном каталоге, соответствующих заданному шаблону поиска и параметрам перечисления. |
Get |
Возвращает имена файлов (включая пути) в заданном каталоге, отвечающие условиям шаблона поиска, используя значение, которое определяет, выполнять ли поиск в подкаталогах. |
Get |
Возвращает имена всех файлов и подкаталогов по указанному пути. |
Get |
Возвращает массив имен файлов и имен каталогов по указанному пути, соответствующих шаблону поиска. |
Get |
Возвращает массив имен файлов и имен каталогов по указанному пути, соответствующих шаблону поиска и параметрам перечисления. |
Get |
Возвращает массив всех имен файлов и каталогов по указанному пути, соответствующих шаблону поиска, и при необходимости ведет поиск в подкаталогах. |
Get |
Возвращает время и дату последнего обращения к указанному файлу или каталогу. |
Get |
Возвращает дату и время последнего доступа к заданному файлу или каталогу в формате всемирного координированного времени (UTC). |
Get |
Возвращает время и дату последней операции записи в указанный файл или каталог. |
Get |
Возвращает дату и время последней операции записи в заданный файл или каталог в формате всемирного координированного времени (UTC). |
Get |
Извлекает имена логических дисков на этом компьютере в формате "<буква> диска:\". |
Get |
Извлекает родительский каталог, на который указывает абсолютный или относительный путь. |
Move(String, String) |
Перемещает файл или каталог со всем его содержимым в новое местоположение. |
Resolve |
Возвращает целевой объект указанной ссылки на каталог. |
Set |
Применяет к заданному каталогу записи списка управления доступом (ACL), описанные объектом DirectorySecurity. |
Set |
Устанавливает дату и время создания заданного файла или каталога. |
Set |
Устанавливает дату и время создания указанного файла или папки в формате всемирного координированного времени (UTC). |
Set |
Устанавливает заданный каталог в качестве текущего рабочего каталога приложения. |
Set |
Устанавливает время и дату последнего обращения к заданному файлу или каталогу. |
Set |
Устанавливает дату и время последнего доступа к заданному файлу или каталогу в формате всемирного координированного времени (UTC). |
Set |
Устанавливает дату и время последней записи в файл или каталог. |
Set |
Устанавливает дату и время последней записи в заданный каталог в формате всемирного координированного времени (UTC). |
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: