Metoda VSProject.GetUniqueFilename —

Generuje unikatową nazwę pliku w ramach projektu.Używany do nazywania nowych elementów projektu.

Przestrzeń nazw:  VSLangProj
Zestaw:  VSLangProj (w VSLangProj.dll)

Składnia

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

Parametry

• pDispatch
  Typ: Object

  Nazwa wygenerowana będzie tę wartość jako rozszerzenie.

• bstrRoot
  Typ: String

  A Project obiektu lub w folderze ProjectItem obiektu.Nazwa pliku wygenerowana będą unikatowe w tym kontekście.

• bstrDesiredExt
  Typ: String

  Nazwa wygenerowana rozpoczyna się od tego ciągu.

Wartość zwracana

Typ: String
Nazwa pliku, który jest unikatowy w projekcie lub w folderze projektu.Jeśli pierwszy parametr jest Project instancji, a następnie nazwa wygenerowana będzie unikatowa w obrębie głównym folderem projektu.Nazwa pliku będzie mieć formę głównego?.Rozszerzenie, gdzie ? jest jeden lub więcej cyfr (1, 2, 3 i tak dalej).

Uwagi

Typowym zastosowaniem tej metody jest do generowania nazwy dla nowego elementu projektu.

Jeśli wywołania tej metody z KeyFile jako katalogu głównego i snk jako rozszerzenie ciąg zwracany jest KeyFile.snk, jeśli plik KeyFile.snk już istnieje.Jeśli plik KeyFile.snk już istnieje, zwracany jest KeyFile1.snk.Należy zauważyć, że jeśli wiele wywołań z tą metodą, a plik nie jest tworzony z nazwy pliku zwracane, wszystkie wywołania będzie zwracać taką samą wartość.Wyniki zależą tylko pliki, które istnieją w momencie wywołania metody.

Przykłady

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

Zabezpieczenia programu .NET Framework

• Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

VSProject Interfejs

Przestrzeń nazw VSLangProj