VSProject2.GetUniqueFilename(Object, String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.