Metodo VSProject.GetUniqueFilename

Articolo
08/11/2011

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
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

Parametri

pDispatch
Tipo: System.Object
Il nome generato presenterà questo valore come estensione.

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

bstrDesiredExt
Tipo: System.String
Il nome generato inizierà con questa stringa.

Valore restituito

Tipo: System.String
Un nome file univoco nel progetto o nella cartella di progetto.Se il primo parametro è un'istanza Project, il nome generato è univoco nella cartella radice del progetto.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 sarà KeyFile.snk, a condizione che il file KeyFile.snk non esista già. Se il file KeyFile.snk esiste già, viene 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 del metodo.

Esempi

[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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

VSProject Interfaccia

Spazio dei nomi VSLangProj

Condividi tramite