VSProject.GetUniqueFilename-Methode

Generiert einen eindeutigen Dateinamen innerhalb des Projekts. Dieser Name wird zur Benennung neuer Projektelemente verwendet.

Namespace: VSLangProj
Assembly: VSLangProj (in vslangproj.dll)

Syntax

'Declaration
'Usage

Parameter

• pDispatch
  Der generierte Name verfügt über diesen Wert als Erweiterung.

• bstrRoot
  Ein Project-Objekt oder ein ProjectItem-Ordnerobjekt. Der generierte Dateiname ist in diesem Kontext eindeutig.

• bstrDesiredExt
  Der generierte Name beginnt mit dieser Zeichenfolge.

Rückgabewert

Ein Dateiname, der im Projekt oder Projektordner eindeutig ist. Wenn es sich beim ersten Parameter um eine Project-Instanz handelt, ist der generierte Name innerhalb des Stammprojektordners eindeutig. Der Dateiname hat das Format Stamm?.Erweiterung, wobei ? einer oder mehreren Ziffern (1, 2, 3 usw.) entspricht.

Hinweise

Diese Methode wird typischerweise angewendet, um einen Namen für ein neues Projektelement zu generieren.

Wenn Sie diese Methode mit KeyFile als Stamm und snk als Erweiterung aufrufen, wird die Zeichenfolge KeyFile.snk zurückgegeben, sofern die Datei KeyFile.snk nicht bereits vorhanden ist. Wenn die Datei KeyFile.snk bereits besteht, wird KeyFile1.snk zurückgegeben. Beachten Sie, dass alle Aufrufe denselben Wert zurückgeben, wenn diese Methode mehrfach aufgerufen und keine Datei aus dem zurückgegebenen Dateinamen erstellt wird. Welche Ergebnisse angezeigt werden, hängt ausschließlich von den Dateien ab, die zum Zeitpunkt des Methodenaufrufs vorhanden waren.

Beispiel

' This macro displays a file name that is unique in the 
' project folder, in the form root?.ext.
' Macro editor
Imports VSLangProj
Imports VSLangProj80
Sub GetUniqueName()
   Dim proj As Project
   proj = DTE.Solution.Projects.Item(1)
   Dim vsproj As VSLangProj.VSProject = _
      CType(proj.Object, VSLangProj.VSProject)
   MsgBox(vsproj.GetUniqueFilename(proj, "Root", "ext"))
End Sub

Siehe auch

Referenz

VSProject-Schnittstelle
VSProject-Member
VSLangProj-Namespace