VCReferences::MatchName Method (String^, Boolean)

Visual Studio 2015

Matches a specified name to the name of a collection item.

Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Syntax

C++

bool MatchName(
	String^ NameToMatch,
	bool FullOnly
)

Parameters

NameToMatch: Type: System::String^
Required. The name to match.

FullOnly

Type: System::Boolean

Required. true if you want MatchName to match the full name of the string. false if you want to allow a match on the short name of the string.

Setting MatchName to true is useful for projects, folders, and files, and requires an absolute path to match. A folder's absolute path is the concatenation of the folder names above it with its own name. A top-level folder's full name is the same as its name. If a folder named Source Files contains a subfolder named MyProject, the MyProject folder full name would be Source Files\MyProject.

Return Value

Type: System::Boolean

true if the name was matched; otherwise, false.

Implements

VCProjectItem::MatchName(String^, Boolean)

Remarks

MatchName operates on a collection item. If you are iterating over the members of a collection, you can use the MatchName method to determine whether the current item is the one in which you are interested .

You can also use MatchName to match debug configurations, regardless of the platform (which is part of the full name Debug\Win32).

You cannot use MatchName for indexing into a collection. Indexing implies using the [] operator or its equivalent .Item() method, which MatchName does not affect either process.