Sdílet prostřednictvím

VSProject2.GetUniqueFilename – metoda (Object, String, String)

  • Článek

Generuje jedinečný název souboru v rámci projektu. se používá 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: System.Object
    Název generovaný má tuto hodnotu jako rozšíření.
  • bstrDesiredExt
    Typ: System.String
    Název generovaný začíná řetězcem.

Vrácená hodnota

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

Implementuje

VSProject.GetUniqueFilename(Object, String, String)

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 pokud více volání této metody žádný soubor je vytvořen 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 kořenové formuláře?.ext. Chcete-li spustit tento příklad-in, viz How to: Compile and Run the Automation Object Model Code Examples. Otevřít Visual Basic nebo Visual C# projektu před spuštěním příkladu.

Visual Basic

" Tento příklad zobrazuje název souboru, který je jedinečný v

' 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

Viz také

Odkaz

VSProject2 Rozhraní

GetUniqueFilename – přetížení

VSLangProj80 – obor názvů