VCAssemblyReference.MatchName-Methode

Artikel
05/16/2015

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: String

Erforderlich. Der Name, mit dem eine Übereinstimmung gefunden werden soll.

FullOnly
Typ: 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 ist mit seinem Namen identisch. Wenn der Ordner Quelldateien den Unterordner MyProject enthält, lautet der vollständige Name des Ordners MyProject Quelldateien\MyProject.

Rückgabewert

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

Hinweise

MatchName ist eine Methode, die einem Auflistungselement ausgeführt wird. Wenn Sie über die Member einer Auflistung durchlaufen, können Sie die MatchName-Methode verwenden, um zu bestimmen, ob das aktuelle Element das ist, für die Sie sich interessieren.

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

Sie können MatchName zum Indizieren nicht in einer Auflistung verwenden. Indizierung bedeutet mithilfe des Operators [] oder der entsprechenden .Item()-Methode, und MatchName beeinflusst nicht jeder Prozess.

Informationen zum Kompilieren und Ausführen dieses Beispiels finden Sie unter Gewusst wie: Kompilieren von Beispielcode für die Erweiterbarkeit von Projektmodellen.

Beispiele

Im folgenden Beispielcode wird die MatchName-Methode VCPlatform 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

VCAssemblyReference Schnittstelle

Microsoft.VisualStudio.VCProjectEngine-Namespace

Freigeben über