VCPlatform.MatchName-Methode

Artikel
05/07/2013

Vergleicht einen angegebenen Namen mit dem Namen eines Auflistungselements.

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

Parameter

NameToMatch
Typ: System.String
Erforderlich.Der Name, mit dem eine Übereinstimmung gefunden werden soll.

FullOnly
Typ: System.Boolean
Erforderlich. true , wenn MatchName eine Übereinstimmung mit dem vollständigen Namen der Zeichenfolge finden soll. false , wenn eine Übereinstimmung mit dem Kurznamen der Zeichenfolge ebenfalls erwünscht ist.
Das Festlegen von MatchName auf true ist für Projekte, Ordner und Dateien sinnvoll und erfordert einen übereinstimmenden absoluten Pfad.Als absoluter Pfad eines Ordners gilt die Verkettung der Namen der übergeordneten Ordner mit dem eigenen Namen des Ordners.Der vollständige Name eines Ordners der obersten Ebene entspricht dem Namen des Ordners.Wenn der Ordner Quelldateien den Unterordner MyProject enthält, lautet der vollständige Name des Ordners MyProject Quelldateien\MyProject.

Rückgabewert

Typ: System.Boolean
true , wenn eine Übereinstimmung mit dem Namen gefunden wurde, andernfalls false.

Hinweise

MatchName ist eine Methode, die an ein Auflistungselement auswirkt.Wenn Sie über die Member einer Auflistung durchlaufen, können Sie die MatchName-Methode können Sie ermitteln, ob das aktuelle Element, für das Sie das Interesse sind.

Sie können auch mithilfe MatchName Debugkonfigurationen, unabhängig von der Plattform (entspricht Teil des vollständigen Namens Win32 \ Debug).

Sie können MatchName zum Indizieren nicht in einer Auflistung verwenden.Indizierung bedeutet mithilfe des [] - Operators oder dessen Entsprechung. Item()- Methode und MatchName wirkt sich nicht auf jeden Prozess.

Beispiele

Weitere Informationen finden Sie unter Gewusst wie: Kompilieren von Beispielcode für die Erweiterbarkeit von Projektmodellen Informationen zum Ändern dieses Beispiel kompiliert und ausgeführt wird.

Im folgenden Beispiel wird die Methode VCPlatformMatchName in der integrierten Entwicklungsumgebung (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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

VCPlatform Schnittstelle

Microsoft.VisualStudio.VCProjectEngine-Namespace

Freigeben über