共用方式為

VSProject2.GetUniqueFilename 方法 (Object, String, String)

  • 發行項

在專案內產生唯一的檔名。 它是用來命名新專案項目。

命名空間：  VSLangProj80
組件：  VSLangProj80 (在 VSLangProj80.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 執行個體，則產生的檔名在根專案資料夾內就不會與其他檔名重複。這個檔案名稱的格式為 Root?.Extension，其中 ? 為一個或多個數字 (1、2、3 依此類推)。

實作

VSProject.GetUniqueFilename(Object, String, String)

備註

這個方法的典型用法是產生新專案項目的名稱。

如果您使用 KeyFile 做為根和 snk 做為副檔名來呼叫這個方法，並且如果 KeyFile.snk 檔尚未存在，則傳回的字串為 KeyFile.snk。 如果 KeyFile.snk 檔已存在，則傳回的字串為 KeyFile1.snk。 請注意，如果對這個方法進行多次呼叫，則不會從傳回的檔名來建立檔案，所有的呼叫都將傳回相同值。 結果僅取決於呼叫方法時存在的檔案。

範例

這個範例顯示專案資料夾中的唯一檔名，其格式為 root?.ext。 若要將此範例當做增益集來執行，請參閱 HOW TO：編譯和執行 Automation 物件模型程式碼範例。 開啟 Visual Basic 或 Visual C# 專案，再執行此範例。

[Visual Basic]

「此範例顯示唯一的檔案名稱

' 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"));
}

.NET Framework 安全性

請參閱

參考

VSProject2 介面

GetUniqueFilename 多載

VSLangProj80 命名空間