VSProject.GetUniqueFilename – metoda

Článek
08/11/2011

Generuje jedinečný název souboru v rámci projektu. Použít pro pojmenování nové položky projektu.

Obor názvů: VSLangProj
Sestavení: VSLangProj (v VSLangProj.dll)

Syntaxe

'Deklarace
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: System.Object
Název generovaný bude mít tuto hodnotu jako rozšíření.

bstrRoot
Typ: System.String
A Project objektu nebo do složky ProjectItem objektu.Název souboru generovaný bude v této souvislosti jedinečný.

bstrDesiredExt
Typ: System.String
Tento řetězec bude začínat název generovaný.

Vrácená hodnota

Typ: System.String
Název souboru je jedinečný ve složce projektu nebo projekt.Pokud je první parametr Project bude instance, pak název generovaný jedinečný v rámci složky Kořenový projekt.Název souboru bude mít formu kořenové?.Rozšíření, kde ? je jeden nebo více číslicemi (1, 2, 3 atd.).

Poznámky

Typické použití této metody je vytvořit název nové položky projektu.

Pokud volání této metody s KeyFile jako kořen a snk jako rozšíření je řetězec vrácený KeyFile.snk, pokud soubor KeyFile.snk již neexistuje. Pokud již existuje soubor KeyFile.snk, KeyFile1.snk vrátil. Všimněte si, že více volání této metody a nevytvoří žádný soubor z vrácených název, vrátí všechna volání stejnou hodnotu. Výsledky závisí pouze na soubory, které existují v okamžiku volání metody.

Příklady

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

VSProject Rozhraní

VSLangProj – obor názvů

Sdílet prostřednictvím