VCUserMacro.MatchName(String, Boolean) Methode

Definition

Vergleicht einen angegebenen Namen mit dem Namen eines Auflistungselements.

public:
 bool MatchName(System::String ^ NameToMatch, bool FullOnly);
public:
 bool MatchName(Platform::String ^ NameToMatch, bool FullOnly);
bool MatchName(std::wstring const & NameToMatch, bool FullOnly);
[System.Runtime.InteropServices.DispId(2406)]
public bool MatchName (string NameToMatch, bool FullOnly);
[<System.Runtime.InteropServices.DispId(2406)>]
abstract member MatchName : string * bool -> bool
Public Function MatchName (NameToMatch As String, FullOnly As Boolean) As Boolean

Parameter

NameToMatch
String

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

FullOnly
Boolean

Erforderlich. true, wenn MatchName(String, Boolean) 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(String, Boolean) 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 identisch mit dessen Namen. Wenn ein Ordner mit dem Namen Quelldateien den Unterordner MyProject enthält, ist der vollständige Name des Ordners MyProject "quelldateien\meinproject."

Gibt zurück

Boolean

true , wenn der Name übereinstimmt. andernfalls false .

Attribute

Hinweise

MatchName arbeitet für ein Sammel Element. Wenn Sie die Elemente einer Auflistung durchlaufen, können Sie die-Methode verwenden, MatchName um zu bestimmen, ob es sich bei dem aktuellen Element um das betreffende Element handelt, für das Sie sich interessieren.

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

Sie können nicht MatchName für die Indizierung in einer Auflistung verwenden. Die Indizierung impliziert die Verwendung des []-Operators oder des entsprechenden. Item ()-Methode, und MatchName wirkt sich nicht auf beide Verfahren aus.

Gilt für