Método VCPlatform.MatchName

Artigo
05/17/2015

Corresponde a um nome especificado para o nome de um item da coleção.

Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (em Microsoft.VisualStudio.VCProjectEngine.dll)

Sintaxe

'Declaração
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

Parâmetros

NameToMatch
Tipo: String

Obrigatório. O nome para corresponder.

FullOnly
Tipo: Boolean

Obrigatório. trueSe você quiser MatchName para coincidir com o nome completo da seqüência de caracteres. falseSe você quiser permitir que uma correspondência no nome curto da seqüência de caracteres.

Definindo MatchName para true é útil para projetos, arquivos e pastas e requer um caminho absoluto para corresponder. A caminho absoluto da pasta é a concatenação de nomes de pasta acima dela, com seu próprio nome. Nome completo de uma pasta nível superior é o mesmo que o seu nome. Se uma pasta chamada arquivos de origem contiver uma subpasta denominada MyProject, o nome completo da pasta MyProject seria Files\MyProject de origem.

Valor de retorno

Tipo: Boolean
true Se o nome foi encontrado; falseCaso contrário.

Comentários

MatchNameé um método que opera em um item da coleção. Se você estiver Iterando até que os membros de uma coleção, você pode usar o MatchName método para determinar se o item atual é aquele no qual você está interessado.

Você também pode usar MatchName para corresponder às configurações de depuração, independentemente da plataforma (que é parte do nome completo Debug\Win32).

Não é possível usar MatchName para indexação em uma coleção. Indexação implica usando o operador [] ou seu equivalente.Método item(), e MatchName não afeta qualquer processo.

Exemplos

Consulte Como compilar um código de exemplo para extensibilidade do modelo de projeto para obter informações sobre como compilar e executar esse exemplo.

O exemplo seguinte modifica a VCPlatformMatchName método no ambiente de desenvolvimento integrado (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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

VCPlatform Interface

Namespace Microsoft.VisualStudio.VCProjectEngine

Compartilhar via