VSProject.GetUniqueFilename メソッド
プロジェクト内で一意のファイル名を生成します。新しいプロジェクト項目に名前を付けるために使用します。
名前空間: VSLangProj
アセンブリ: VSLangProj (vslangproj.dll 内)
構文
'宣言
'使用
パラメータ
- pDispatch
生成されるファイル名の拡張子になります。
- bstrRoot
Project オブジェクトまたはフォルダの ProjectItem オブジェクト。生成されるファイル名は、このコンテキスト内で一意になります。
- bstrDesiredExt
生成される名前は、この文字列で始まります。
戻り値
プロジェクトまたはプロジェクト フォルダで一意のファイル名を返します。最初のパラメータが Project インスタンスの場合、生成される名前はルート プロジェクト フォルダ内で一意になります。ファイル名は Root?.Extension の形式です。? には、1、2、3 などの 1 つ以上の数字が入ります。
解説
このメソッドは一般的に、新しいプロジェクト項目の名前を生成するときに使用します。
Root に KeyFile、Extension に snk を指定してこのメソッドを呼び出したときに、KeyFile.snk というファイルが存在しない場合は KeyFile.snk という文字列が返されます。KeyFile.snk というファイルが既に存在する場合は、KeyFile1.snk が返されます。このメソッドを複数回呼び出しても返されたファイル名のファイルが作成されない場合は、すべての呼び出しで同じ値が返されます。結果は、メソッドの呼び出し時に存在するファイルによって決まります。
使用例
' 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