Método VSProject.GetUniqueFilename

Artigo
08/01/2011

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
Function GetUniqueFilename ( _
    pDispatch As Object, _
    bstrRoot As String, _
    bstrDesiredExt As String _
) As String

string GetUniqueFilename(
    Object pDispatch,
    string bstrRoot,
    string bstrDesiredExt
)

String^ GetUniqueFilename(
    [InAttribute] Object^ pDispatch, 
    [InAttribute] String^ bstrRoot, 
    [InAttribute] String^ bstrDesiredExt
)

abstract GetUniqueFilename : 
        pDispatch:Object * 
        bstrRoot:string * 
        bstrDesiredExt:string -> string

function GetUniqueFilename(
    pDispatch : Object, 
    bstrRoot : String, 
    bstrDesiredExt : String
) : String

Parâmetros

pDispatch
Tipo: System.Object
O nome gerado terá esse valor como a extensão.

bstrRoot
Tipo: System.String
A Project objeto ou uma pasta ProjectItem objeto.O nome de arquivo gerado será exclusivo dentro desse contexto.

bstrDesiredExt
Tipo: System.String
O nome gerado será iniciado com essa seqüência de caracteres.

Valor de retorno

Tipo: System.String
Um nome de arquivo exclusivo no projeto ou pasta do projeto.Se o primeiro parâmetro é um Project instância, e em seguida, o nome gerado seja exclusivo dentro da pasta de projeto raiz.O nome do arquivo assumirá a forma raiz?.Extensão, onde ? é um ou mais numerais (1, 2, 3 e assim por diante).

Comentários

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

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

Exemplos

[Visual Basic]

' 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

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áveis.

Consulte também

Referência

VSProject Interface

Namespace VSLangProj

Partilhar via