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

Článek
10/27/2012

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

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 přípona.

bstrRoot
Typ: System.String
A Project objekt nebo do složky ProjectItem objekt. Je název souboru generovaný jedinečný v kontext.

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 projekt nebo projekt .Pokud je první parametr Project instance je název generovaný jedinečný v kořensložceprojekt . Má název souboru formulářkořenové?.Rozšíření, kde ? je jeden nebo více číslicemi (1, 2, 3 atd.).

Poznámky

Typické použití této metoda je vytvořit název pro novoupoložka projekt.

Pokud volání této metoda s KeyFile jako kořen a snk jako příponaje ř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 metoda žádný soubor je vytvořen z vrácených název souboru, všechna volání vrátí stejnou hodnotu.Výsledky závisí pouze na soubory, které existují v okamžiku volání metoda .

Příklady

Tento příklad zobrazí název souboru , který je jedinečný ve složce projekt ve formulář kořen?.ext.Chcete-li spustit tento příklad doplněk, viz Jak: kompilace a spuštění příkladů kódu automatizace objektu modelu.Otevřít Visual Basic nebo Visual C# projekt před spuštěním tohoto 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í

GetUniqueFilename – přetížení

VSLangProj80 – obor názvů

Sdílet prostřednictvím