VCAssemblyReference.MatchName, méthode

Article
05/16/2015

Met en correspondance un nom spécifié avec le nom d'un élément de collecte.

Espace de noms : Microsoft.VisualStudio.VCProjectEngine
Assembly : Microsoft.VisualStudio.VCProjectEngine (dans Microsoft.VisualStudio.VCProjectEngine.dll)

Syntaxe

'Déclaration
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

Paramètres

NameToMatch
Type : String

Obligatoire. Nom à mettre en correspondance.

FullOnly
Type : Boolean

Obligatoire. true si vous voulez que MatchName corresponde au nom complet de la chaîne. false si vous souhaitez autoriser une correspondance avec le nom court de la chaîne.

Le fait d'affecter à MatchName la valeur true est utile pour les projets, les dossiers et les fichiers et requiert de faire correspondre un chemin d'accès absolu. Le chemin d'accès absolu d'un dossier est la concaténation des noms des dossiers situés au-dessus de ce dossier avec le nom de celui-ci. Le nom complet d'un dossier de niveau supérieur est identique à son nom. Si un dossier nommé Fichiers sources contient un sous-dossier nommé MonProjet, le nom complet du dossier MonProjet est Fichiers Sources\MonProjet.

Valeur de retour

Type : Boolean
true si le nom a été mis en correspondance ; sinon, false.

Notes

MatchName est une méthode qui gère un élément de collecte. Si vous itérez sur les membres d'une collection, vous pouvez utiliser la méthode de MatchName pour déterminer si l'élément actuel est celle dans laquelle vous intéressent.

Vous pouvez également utiliser MatchName pour faire correspondre des fonctionnalités de débogage, quelle que soit la plateforme (qui fait partie du débogage\Win32 full name).

Vous ne pouvez pas utiliser MatchName pour indexer dans une collection. L'indexation consiste à l'aide de l'opérateur [] ou sa méthode équivalente d'.Item() , et MatchName n'affecte pas l'un ou l'autre de processus.

Pour plus d'informations sur la compilation et l'exécution de cet exemple, consultez Comment : compiler l'exemple de code pour l'extensibilité du modèle de projet.

Exemples

L'exemple de code suivant modifie la méthode de MatchName d'VCPlatform dans l'environnement de développement intégré (IDE) :

' add reference to Microsoft.VisualStudio.VCProjectEngine.
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine

Public Module Module1
    Sub Test()
        Dim prj As VCProject
        Dim cfgs, tools As IVCCollection
        Dim cfg As VCConfiguration
        Dim p As VCPlatform
        prj = DTE.Solution.Projects.Item(1).Object
        p = prj.Platforms(1)

        If p.MatchName("Win32", True) Then
            p.ExecutableDirectories = "T"
        End If

    End Sub
End Module

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

VCAssemblyReference Interface

Microsoft.VisualStudio.VCProjectEngine, espace de noms

Partager via