VCAssemblyReference.MatchName (Método)

Compara un nombre especificado con el nombre de un elemento de colección.

Espacio de nombres:  Microsoft.VisualStudio.VCProjectEngine
Ensamblado:  Microsoft.VisualStudio.VCProjectEngine (en Microsoft.VisualStudio.VCProjectEngine.dll)

Sintaxis

'Declaración
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

  Obligatorio. Nombre que se va a comparar.

• FullOnly
  Tipo: Boolean

  Obligatorio. Es true si desea que MatchName busque coincidencias con el nombre completo de la cadena. Es false si desea permitir que se busquen coincidencias con el nombre corto de la cadena.

  Resulta útil establecer MatchName en true en los proyectos, carpetas y archivos, para lo cual se necesita una ruta de acceso absoluta que coincida. La ruta de acceso absoluta de una carpeta es la concatenación de los nombres de las carpetas que se encuentran en niveles superiores junto con su propio nombre. El nombre completo de una carpeta de nivel superior coincide con su nombre. Si una carpeta denominada Archivos de origen contiene una subcarpeta denominada MiProyecto, el nombre completo de la carpeta MiProyecto es Archivos de origen\MiProyecto.

Valor devuelto

Tipo: Boolean
Es true se encuentran coincidencias con el nombre; de lo contrario, es false.

Comentarios

MatchName es un método que funcione en un elemento de colección. Si se itera sobre los miembros de una colección, puede utilizar el método de MatchName para determinar si el elemento actual es el en el que esté interesado.

También puede utilizar MatchName para coincidir con la configuración de depuración, independientemente de la plataforma (que forma parte del nombre completo Debug\Win32).

No puede utilizar MatchName para indizar en una colección. La indización implica utilizar [] el operador o el método equivalente de .Item() , y MatchName no afecta a cualquier proceso.

Vea Cómo: Compilar el código de ejemplo de extensibilidad del modelo de proyecto para obtener información acerca de la compilación y ejecución de este ejemplo.

Ejemplos

El código de ejemplo siguiente se modifica el método de MatchName de VCPlatform en el entorno de desarrollo 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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

VCAssemblyReference Interfaz

Microsoft.VisualStudio.VCProjectEngine (Espacio de nombres)