FileSystem.FindInFiles Метод

Ссылка

Определение

Пространство имен:: Microsoft.VisualBasic.FileIO

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает доступный только для чтения набор строк, представляющих собой имена файлов, которые содержат указанный текст.

Перегрузки

FindInFiles(String, String, Boolean, SearchOption)	Возвращает доступный только для чтения набор строк, представляющих собой имена файлов, которые содержат указанный текст.
FindInFiles(String, String, Boolean, SearchOption, String[])	Возвращает доступный только для чтения набор строк, представляющих собой имена файлов, которые содержат указанный текст.

FindInFiles(String, String, Boolean, SearchOption)

Исходный код:: FileSystem.vb

Исходный код:: FileSystem.vb

Исходный код:: FileSystem.vb

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);

static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption) As ReadOnlyCollection(Of String)

Параметры

directory: String

Каталог, в котором необходимо выполнить поиск.

containsText: String

Текст, поиск которого необходимо выполнить.

ignoreCase: Boolean

Значение True, если при поиске следует учитывать регистр; в противном случае — значение False. Значение по умолчанию — True.

searchType: SearchOption

Указывает, нужно ли включать вложенные папки. Значение по умолчанию — SearchOption.SearchTopLevelOnly.

Возвращаемое значение

ReadOnlyCollection<String>

Доступная только для чтения коллекция имен файлов, содержащих указанный текст.

Исключения

ArgumentException

Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \.</code>).


		
		    
			    ArgumentNullException
		    
		    Параметр directory имеет значение Nothing или является пустой строкой.

		
		
		    
			    DirectoryNotFoundException
		    
		    Заданный каталог не существует.

		
		
		    
			    IOException
		    
		    Заданный каталог указывает на существующий файл.

		
		
		    
			    PathTooLongException
		    
		    Длина пути превышает максимальную длину, определенную в системе.

		
		
		    
			    NotSupportedException
		    
		    Указанный путь каталога содержит двоеточие (:) или имеет недопустимый формат.

		
		
		    
			    SecurityException
		    
		    У пользователя отсутствуют необходимые разрешения на просмотр пути.

		
		
		    
			    UnauthorizedAccessException
		    
		    У пользователя нет необходимых разрешений.

		

  Примеры
    	В этом примере выполняется поиск в каталоге C:\TestDir файлов, содержащих строку "sample string" , и результаты отображаются в ListBox1.
Dim list As System.Collections.ObjectModel.
  ReadOnlyCollection(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", 
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name In list
    ListBox1.Items.Add(name)
Next

Для работы проект должен содержать ListBox с именем ListBox1.


    	Комментарии
    	Если файлы, соответствующие указанному шаблону, не найдены, возвращается пустая коллекция.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.FindInFiles метод .



Кому
См.




Поиск каталог для файлов, содержащих определенную строку
Пошаговое руководство: Операции с файлами и каталогами в Visual Basic








    	См. также раздел
    	
SearchOption
ReadOnlyCollection<T>


  
  Применяется к

Кому	См.
Поиск каталог для файлов, содержащих определенную строку	Пошаговое руководство: Операции с файлами и каталогами в Visual Basic




	FindInFiles(String, String, Boolean, SearchOption, String[])



	
		Исходный код:
FileSystem.vb
	
	
		Исходный код:
FileSystem.vb
	
	
		Исходный код:
FileSystem.vb
	

	
		
			Возвращает доступный только для чтения набор строк, представляющих собой имена файлов, которые содержат указанный текст.

		
	
	public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ fileWildcards);
	public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);
	static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
	Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption, ParamArray fileWildcards As String()) As ReadOnlyCollection(Of String)
	Параметры
	
		
			
			
			directory
			
			
				String
				
			
		
		Каталог, в котором необходимо выполнить поиск.

	
	
		
			
			
			containsText
			
			
				String
				
			
		
		Текст, поиск которого необходимо выполнить.

	
	
		
			
			
			ignoreCase
			
			
				Boolean
				
			
		
		Значение True, если при поиске следует учитывать регистр; в противном случае — значение False. Значение по умолчанию — True.

	
	
		
			
			
			searchType
			
			
				SearchOption
				
			
		
		Указывает, нужно ли включать вложенные папки. Значение по умолчанию — SearchOption.SearchTopLevelOnly.

	
	
		
			
			
			fileWildcards
			
			
				String[]
				
			
		
		Шаблон, которому необходимо соответствовать.

	
	Возвращаемое значение



	
		ReadOnlyCollection<String>
		
	

	Доступная только для чтения коллекция имен файлов, содержащих указанный текст.



	Исключения
		
		    
			    ArgumentException
		    
		    Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \.</code>).


		

		
		    
			    ArgumentNullException
		    
		    Параметр directory имеет значение Nothing или является пустой строкой.

		
		
		    
			    DirectoryNotFoundException
		    
		    Заданный каталог не существует.

		
		
		    
			    IOException
		    
		    Заданный каталог указывает на существующий файл.

		
		
		    
			    PathTooLongException
		    
		    Длина пути превышает максимальную длину, определенную в системе.

		
		
		    
			    NotSupportedException
		    
		    Указанный путь каталога содержит двоеточие (:) или имеет недопустимый формат.

		
		
		    
			    SecurityException
		    
		    У пользователя отсутствуют необходимые разрешения на просмотр пути.

		
		
		    
			    UnauthorizedAccessException
		    
		    У пользователя нет необходимых разрешений.

		

  Примеры
    	В этом примере выполняется поиск в каталоге C:\TestDir файлов, содержащих строку "sample string" , и результаты отображаются в ListBox1.
Dim list As System.Collections.ObjectModel.
  ReadOnlyCollection(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", 
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name In list
    ListBox1.Items.Add(name)
Next

Для работы проект должен содержать ListBox с именем ListBox1.


    	Комментарии
    	Если файлы, соответствующие указанному шаблону, не найдены, возвращается пустая коллекция.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.FindInFiles метод .



Кому
См.




Поиск каталог для файлов, содержащих определенную строку
Пошаговое руководство: Операции с файлами и каталогами в Visual Basic








    	См. также раздел
    	
SearchOption
ReadOnlyCollection<T>


  
  Применяется к

Поделиться через

FileSystem.FindInFiles Метод

Определение

Перегрузки

FindInFiles(String, String, Boolean, SearchOption)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

FindInFiles(String, String, Boolean, SearchOption, String[])

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы