VSProject2.GetUniqueFilename – metoda

Článek
05/16/2015

Generuje jedinečný název souboru v rámci projektu. používá se k pojmenování nové položky projektu.

Obor názvů: VSLangProj80
Sestavení: VSLangProj80 (v VSLangProj80.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: Object

Jméno vygenerované má tuto hodnotu jako rozšíření.

bstrRoot
Typ: String

A Project objektu nebo do složky ProjectItem objektu.Název souboru generovaný je jedinečné v této souvislosti.

bstrDesiredExt
Typ: String

Jméno vygenerované začíná řetězcem.

Vrácená hodnota

Typ: String
Řetězec představující název souboru, který je jedinečný v projektu nebo ve složce projektu.Pokud je první parametr Project , pak je v kořenové složce projektu jedinečný název vytvořené instance.Název souboru má tvar kořenové?.Rozšíření, kde ? je nejméně jedna číslice (1, 2, 3 a tak dále).

Poznámky

Typické použití této metody je vytvořit název pro novou položku projektu.

Při 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 bude vrácena.Všimněte si, že pokud více volání této metody, nevytvoří se žádný soubor z názvu souboru vrácená všechna volání vrátí stejnou hodnotu.Výsledky závisí pouze na soubory, které existují v okamžiku volání metody.

Příklady

Tento příklad zobrazuje název souboru, který je jedinečný ve složce projektu v kořenovém adresáři formuláře?.ext. Chcete-li spustit tento příklad jako doplněk, viz Postupy: Kompilace a spuštění příkladů kódu objektu automatizace.Otevřené Visual Basic nebo Visual C# projektu před spuštěním v tomto příkladu.

[Visual Basic]

' This example displays a file name that is unique in the 
     ' project folder, in the form, root?.ext.
Public Sub OnConnection(ByVal application As Object,_
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    applicationObject = CType(application, DTE2)
    addInInstance = CType(addInInst, AddIn)
    GetUniqueName(applicationObject)
End Sub
Sub GetUniqueName(ByVal dte As DTE2)
    Dim proj As Project
    proj = applicationObject.Solution.Projects.Item(1)
    Dim vsproj As VSLangProj80.VSProject2 = _
    CType(proj.Object, VSLangProj80.VSProject2)
    MsgBox(vsproj.GetUniqueFilename(proj, "Root", "ext"))
End Sub

[C#]

using System.Windows.Forms;
using VSLangProj;
using VSLangProj2;
using VSLangProj80;
// This example displays a file name that is unique in the 
// project folder, in the form, root?.ext.
public void OnConnection(object application,
 ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    applicationObject = (DTE2)application;
    addInInstance = (AddIn)addInInst;
    GetUniqueName((DTE2)applicationObject);
}
public void GetUniqueName(DTE2 dte)
{
    Project proj = null;
    proj = applicationObject.Solution.Projects.Item(1);
    VSLangProj80.VSProject2 vsproj = 
((VSLangProj80.VSProject2)(proj.Object));
    MessageBox.Show(vsproj.GetUniqueFilename(proj, "Root", "ext"));
}

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é

Referenční dokumentace

VSProject2 Rozhraní

VSLangProj80 – obor názvů

Sdílet prostřednictvím