VSProject.GetUniqueFilename (Método)

Artigo
06/30/2009

Gera um nome de arquivo exclusivo dentro do projeto. Usado para nomear novos itens de projeto.

Namespace: VSLangProj
Assembly: VSLangProj (em vslangproj.dll)

Sintaxe

'Declaração
'Uso

Parâmetros

pDispatch
O nome gerado terá esse valor como a extensão.

bstrRoot
Um Project objeto ou um objeto pasta ProjectItem. O nome de arquivo gerado será exclusivo dentro neste contexto.

bstrDesiredExt
O nome gerado será iniciado com esta seqüência.

Valor de retorno

Um nome de arquivo que é exclusivo no projeto ou pasta do projeto. Se o primeiro parâmetro é uma Project instância, então o nome gerado será exclusivo na pasta de raiz do projeto. Nome de arquivo será assumem a forma Root?.Extension, onde ? é numerais um ou mais. (1, 2, 3, e assim por diante)

Comentários

Um uso típico para este método é a gerar um nome para um novo item de projeto.

Se você chamar esse método com KeyFile a extensão, como a raiz e snk a seqüência retornada é KeyFile.snk, se o arquivo KeyFile.snk ainda não existir. Se o arquivo KeyFile.snk já existir, então KeyFile1.snk será retornado. Observe que se várias chamadas são feitas para esse método, e nenhum arquivo é criado do nome arquivos retornados, todas as chamadas retornará o mesmo valor. Os resultados dependem da somente os arquivos que existem no momento do chamada de método.

Exemplo

' 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

Consulte também

Referência

VSProject (Interface)
VSProject (Membros)
VSLangProj (Namespace)

Compartilhar via