Share via


VCReferences.MatchName Method

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

'Declaration
Function MatchName ( _
    NameToMatch As String, _
    FullOnly As Boolean _
) As Boolean
bool MatchName(
    string NameToMatch,
    bool FullOnly
)
bool MatchName(
    [InAttribute] String^ NameToMatch, 
    [InAttribute] bool FullOnly
)
abstract MatchName : 
        NameToMatch:string * 
        FullOnly:bool -> bool
function MatchName(
    NameToMatch : String, 
    FullOnly : boolean
) : boolean

Parameters

  • NameToMatch
    Type: String

    Required. The name to match.

  • FullOnly
    Type: 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: Boolean
true if the name was matched; otherwise, false.

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.

.NET Framework Security

See Also

Reference

VCReferences Interface

Microsoft.VisualStudio.VCProjectEngine Namespace