VCReferences.MatchName(String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сопоставляет указанное имя с именем элемента коллекции.
public:
bool MatchName(System::String ^ NameToMatch, bool FullOnly);
public:
bool MatchName(Platform::String ^ NameToMatch, bool FullOnly);
bool MatchName(std::wstring const & NameToMatch, bool FullOnly);
[System.Runtime.InteropServices.DispId(675)]
public bool MatchName (string NameToMatch, bool FullOnly);
[<System.Runtime.InteropServices.DispId(675)>]
abstract member MatchName : string * bool -> bool
Public Function MatchName (NameToMatch As String, FullOnly As Boolean) As Boolean
Параметры
- NameToMatch
- 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 не влияет ни на один из процессов.