VSProject.GetUniqueFilename-Methode

Artikel
08/10/2011

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

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

Syntax

'Declaration
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

Parameter

pDispatch
Typ: System.Object
Der generierte Name verfügt über diesen Wert als Erweiterung.

bstrRoot
Typ: System.String
Ein Project-Objekt oder ein ProjectItem-Ordnerobjekt.Der generierte Dateiname ist in diesem Kontext eindeutig.

bstrDesiredExt
Typ: System.String
Der generierte Name beginnt mit dieser Zeichenfolge.

Rückgabewert

Typ: System.String
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 erstellen.

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 noch nicht 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 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.

Beispiele

[Visual Basic]

' 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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

VSProject Schnittstelle

VSLangProj-Namespace

Freigeben über