通过

VSProject.GetUniqueFilename 方法

  • 项目

生成项目内的唯一文件名。 用于命名新项目项。

命名空间：  VSLangProj
程序集：  VSLangProj（在 VSLangProj.dll 中）

语法

声明
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

参数

  • pDispatch
    类型：System.Object
    生成的名称将该值作为扩展名。
  • bstrDesiredExt
    类型：System.String
    生成的文件名将以此字符串起始。

返回值

类型：System.String
在项目或项目文件夹内是唯一的文件名。如果第一个参数是 Project 实例，则生成的名称在根项目文件夹内将是唯一的。该文件名将采用的格式为根?.扩展名，其中 ? 为一个或多个数字（1、2、3 等）。

备注

此方法常用于为新的项目项生成名称。

如果将 KeyFile 作为根，将 snk 作为扩展名调用此方法，则返回的字符串为 KeyFile.snk（如果文件 KeyFile.snk 尚未存在）。 如果文件 KeyFile.snk 已存在，则返回 KeyFile1.snk。 请注意，如果对此方法进行多个调用，并且没有从返回的文件名创建任何文件，则所有调用将返回相同的值。 结果只取决于在该方法调用时存在的文件。

示例

[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 安全性

请参见

参考

VSProject 接口

VSLangProj 命名空间