VSProject2.GetUniqueFilename(Object, String, String) Methode

Definition

Generiert einen eindeutigen Dateinamen innerhalb des Projekts. Sie wird zum Benennen neuer Projekt Elemente verwendet.

public:
 System::String ^ GetUniqueFilename(System::Object ^ pDispatch, System::String ^ bstrRoot, System::String ^ bstrDesiredExt);
public:
 Platform::String ^ GetUniqueFilename(Platform::Object ^ pDispatch, Platform::String ^ bstrRoot, Platform::String ^ bstrDesiredExt);
std::wstring GetUniqueFilename(winrt::Windows::Foundation::IInspectable const & pDispatch, std::wstring const & bstrRoot, std::wstring const & bstrDesiredExt);
[System.Runtime.InteropServices.DispId(16)]
public string GetUniqueFilename (object pDispatch, string bstrRoot, string bstrDesiredExt);
[<System.Runtime.InteropServices.DispId(16)>]
abstract member GetUniqueFilename : obj * string * string -> string
Public Function GetUniqueFilename (pDispatch As Object, bstrRoot As String, bstrDesiredExt As String) As String

Parameter

pDispatch
Object

Der generierte Name weist diesen Wert als Erweiterung auf.

bstrRoot
String

Ein- Project Objekt oder ein Ordner ProjectItem Objekt. Der generierte Dateiname ist innerhalb dieses Kontexts eindeutig.

bstrDesiredExt
String

Der generierte Name beginnt mit dieser Zeichenfolge.

Gibt zurück

String

Eine Zeichenfolge, die einen Dateinamen darstellt, der im Projekt-oder Projektordner eindeutig ist. Wenn der erste Parameter eine- Project Instanz ist, ist der generierte Name innerhalb des Stamm Projekt Ordners eindeutig. Der Dateiname hat die Form root?. Erweiterung, wo? ist eine oder mehrere Ziffern (1, 2, 3 usw.).

Implementiert

Attribute

Beispiele

In diesem Beispiel wird ein Dateiname angezeigt, der im Projektordner im Format Root? eindeutig ist. Antrags. Informationen zum Ausführen dieses Beispiels als Add-in finden Sie unter Gewusst wie: Kompilieren und Ausführen der Code Beispiele für das Automatisierungs Objektmodell. Öffnen Sie ein- Visual Basic oder- Visual C# Projekt, bevor Sie dieses Beispiel ausführen.

[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"));  
}  

Hinweise

Eine typische Verwendung dieser Methode besteht darin, einen Namen für ein neues Projekt Element zu generieren.

Wenn Sie diese Methode mit keyfile als Stamm und snk als Erweiterung aufzurufen, ist die zurückgegebene Zeichenfolge KeyFile. snk, wenn die Datei "keyfile. snk" nicht bereits vorhanden ist. Wenn die Datei "keyfile. snk" bereits vorhanden ist, wird "KeyFile1. snk" zurückgegeben. Beachten Sie, dass alle Aufrufe denselben Wert zurückgeben, wenn mehrere Aufrufe an diese Methode erfolgt sind und keine Datei aus dem zurückgegebenen Dateinamen erstellt wird. Die Ergebnisse hängen nur von den Dateien ab, die zum Zeitpunkt des Methoden Aufrufes vorhanden sind.

Gilt für