Metodo VSProject.GetUniqueFilename

Articolo
08/22/2007

Questo metodo consente di generare un nome file univoco all'interno del progetto. Viene utilizzato per denominare nuovi elementi di progetto.

Spazio dei nomi: VSLangProj
Assembly: VSLangProj (in vslangproj.dll)

Sintassi

'Dichiarazione
'Utilizzo

Parametri

pDispatch
Il nome generato presenterà questo valore come estensione.

bstrRoot
Oggetto Project oppure oggetto ProjectItem della cartella. Il nome file generato sarà univoco all'interno di questo contesto.

bstrDesiredExt
Il nome generato inizierà con questa stringa.

Valore restituito

Un nome file univoco nel progetto o nella cartella di progetto. Se il primo parametro è un'istanza Project, il nome generato è univoco nella cartella del progetto di primo livello. Il formato del nome file sarà Radice?.Estensione, dove ? rappresenta uno o più numeri (1, 2, 3 e così via).

Note

Un utilizzo tipico di questo metodo consiste nel generare un nome per un nuovo elemento di progetto.

Se si chiama questo metodo con KeyFile come radice e snk come estensione, la stringa restituita è KeyFile.snk, a condizione che il file KeyFile.snk non esista già. Se il file KeyFile.snk esiste già, verrà restituito KeyFile1.snk. Si noti che nel caso vengano effettuate più chiamate a questo metodo, senza che venga creato alcun file con il nome del file restituito, tutte le chiamate daranno come risultato lo stesso valore. I risultati dipendono unicamente dai file esistenti al momento della chiamata al metodo.

Esempio

' 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

Vedere anche

Riferimenti

Interfaccia VSProject
Membri VSProject
Spazio dei nomi VSLangProj

Condividi tramite