Metodo VCAssemblyReference.MatchName

Articolo
05/16/2015

Confronta un nome specificato con il nome di un elemento della raccolta.

Spazio dei nomi: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Sintassi

'Dichiarazione
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

Parametri

NameToMatch
Tipo: String

Obbligatorio. Nome da confrontare.

FullOnly
Tipo: Boolean

Obbligatorio. true se si desidera che MatchName individui la corrispondenza con il nome completo della stringa. false se si desidera consentire una corrispondenza in base al nome breve della stringa.

L'impostazione di MatchName su true è utile per progetti, cartelle e file e richiede la corrispondenza di un percorso assoluto. Il percorso assoluto di una cartella è la concatenazione dei nomi delle cartelle dei livelli superiori con il nome della cartella. Il nome completo di una cartella di livello superiore corrisponderebbe al proprio nome. Se una cartella denominata File di origine contiene una sottocartella denominata Progetto, il nome completo della cartella Progetto è File di origine\Progetto.

Valore restituito

Tipo: Boolean
true se è stata trovata una corrispondenza con il nome. In caso contrario, false.

Note

MatchName è un metodo che fa in modo che operi su un elemento della raccolta. Se si sta scorrendo i membri di una raccolta, è possibile utilizzare il metodo di MatchName per determinare se l'elemento corrente è quello desiderato.

È inoltre possibile utilizzare MatchName per soddisfare le configurazioni di debug, indipendentemente dalla piattaforma incluso il debug \ Win32 fullname).

Non è possibile utilizzare MatchName per l'indicizzazione in una raccolta. Indicizzazione implica l'utilizzo [] dell'operatore o il relativo metodo equivalente di .Item() e MatchName non influisce su qualsiasi processo.

Per informazioni sulle modalità di compilazione e di esecuzione di questo esempio, vedere Procedura: compilare codice di esempio per l'Extensibility del modello di progetto .

Esempi

Il seguente codice di esempio viene modificato il metodo di MatchName di VCPlatform nell'ambiente di sviluppo integrato (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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

VCAssemblyReference Interfaccia

Spazio dei nomi Microsoft.VisualStudio.VCProjectEngine

Condividi tramite