VSProject.GetUniqueFilename (Método)

Genera un nombre de archivo único en el proyecto que se usa para denominar a los nuevos elementos del proyecto.

Espacio de nombres: VSLangProj
Ensamblado: VSLangProj (en vslangproj.dll)

Sintaxis

'Declaración
'Uso

Parámetros

• pDispatch
  El nombre generado tendrá este valor como extensión.

• bstrRoot
  Un objeto Project o un objeto ProjectItem de carpeta. El nombre de archivo generado será único en este contexto.

• bstrDesiredExt
  El nombre generado comenzará con esta cadena.

Valor devuelto

Nombre de archivo que es único en el proyecto o en la carpeta del proyecto. Si el primer parámetro es una instancia del objeto Project, el nombre generado será único en la carpeta raíz del proyecto. El nombre de archivo adoptará el formato Raíz?.Extensión, donde ? corresponde a uno o varios numerales (1, 2, 3, etc.).

Comentarios

Un uso típico de este método consiste en generar un nombre para un nuevo elemento del proyecto.

Si se llama a este método con KeyFile como raíz y snk como extensión, la cadena devuelta será KeyFile.snk, siempre y cuando el archivo KeyFile.snk no exista todavía. Si existe, se devolverá KeyFile1.snk. Debe tenerse en cuenta que si se realizan varias llamadas a este método y no se crea ningún archivo a partir del nombre de archivo devuelto, todas las llamadas devolverán el mismo valor. El resultado depende sólo de los archivos que existan en el momento de la llamada al método.

Ejemplo

' This macro displays a file name that is unique in the 
' project folder, in the form root?.ext.
' Macro editor
Imports VSLangProj
Imports VSLangProj80
Sub GetUniqueName()
   Dim proj As Project
   proj = DTE.Solution.Projects.Item(1)
   Dim vsproj As VSLangProj.VSProject = _
      CType(proj.Object, VSLangProj.VSProject)
   MsgBox(vsproj.GetUniqueFilename(proj, "Root", "ext"))
End Sub

Vea también

Referencia

VSProject (Interfaz)
VSProject (Miembros)
VSLangProj (Espacio de nombres)