VCFileConfiguration.MatchName(String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сопоставляет указанное имя с именем элемента коллекции.
public:
bool MatchName(System::String ^ bstrNameToMatch, bool FullOnly);
public:
bool MatchName(Platform::String ^ bstrNameToMatch, bool FullOnly);
bool MatchName(std::wstring const & bstrNameToMatch, bool FullOnly);
[System.Runtime.InteropServices.DispId(510)]
public bool MatchName (string bstrNameToMatch, bool FullOnly);
[<System.Runtime.InteropServices.DispId(510)>]
abstract member MatchName : string * bool -> bool
Public Function MatchName (bstrNameToMatch As String, FullOnly As Boolean) As Boolean
Параметры
- bstrNameToMatch
- String
Обязательный. Сопоставляемое имя.
- FullOnly
- Boolean
Обязательный. Значение true, если требуется, чтобы метод MatchName(String, Boolean) выполнил сопоставление с полным именем строки. Значение false, если допускается сопоставление с коротким именем строки.
Задание для MatchName(String, Boolean) значения true бывает полезно при работе с проектами, папками и файлами, при этом указанный сопоставляемый путь должен быть абсолютным. Абсолютный путь к папке — это объединение имени папки с именами ее вышестоящих папок. Имя любой папки верхнего уровня совпадает с ее полным именем. Если в папке Source Files содержится вложенная папка MyProject, полным именем папки MyProject будет Source Files\MyProject.
Возвращаемое значение
Значение true, если обнаружено соответствие имени; в противном случае — значение false.
- Атрибуты
Комментарии
MatchName работает с элементом сбора. При переборе элементов коллекции можно использовать MatchName метод, чтобы определить, является ли текущий элемент тем, в котором вы заинтересованы.
Также можно использовать MatchName для сопоставления конфигураций отладки независимо от платформы (которая является частью полного имени Debug\Win32).
Нельзя использовать MatchName для индексирования в коллекции. Индексация подразумевает использование оператора [] или его эквивалента. Item () и MatchName не влияет ни на один из процессов.