References.Add 方法
將新的參考加入專案。
命名空間: VSLangProj
組件: VSLangProj (在 vslangproj.dll 中)
語法
'宣告
'用途
參數
bstrPath
必要項。COM 或 .NET Frameworks 參考的路徑。這個參數可有三種格式:
簡單的 .NET Framework 物件名稱,例如「System」。
.NET Framework 檔名 (.tlb、.dll 或 .ocx 檔)。
COM 程式庫檔案 (.tlb、.dll、.ocx 或 .exe 檔案)。COM 物件的路徑需要包含完整路徑及檔名,例如「D:\SomeApplication\SomeApp.dll」。如需加入 COM .exe 檔案參考的限制,請參閱下節的<COM 參考>。
傳回值
傳回 Reference 物件。
備註
如果 bstrPath 參數指定的檔案中沒有型別程式庫,或是無法解析參考 (請參閱「參考解析」段落),便會產生錯誤。
如果專案中有一項參考的 Identity、Culture、MajorVersion、MinorVersion、BuildNumber 和 RevisionNumber 與新參考的相同,這個方法就不會產生錯誤。這種情況表示 bstrPath 參數指定的參考已經加入到專案內。而會將已存在專案中相符參考的 ProjectItem 傳回。
如果專案中有一個參考具有相同的 Identity,但它的 MajorVersion、MinorVersion、BuildNumber、RevisionNumber 或 Culture 不同,則此方法會產生錯誤。
若要移除參考,請使用 Remove。
範例
' Macro Editor
Imports VSLangProj
Sub AddExample()
' This example assumes that the first project in the solution is
' either a Visual Basic or C# project.
Dim aVSProject As VSProject = _
CType(DTE.Solution.Projects.Item(1).Object, VSProject)
Dim refs As References = aVSProject.References
' Adds a reference to a compiled .NET project.
refs.Add("C:\path\program.dll")
' Adds a reference to an installed ActiveX control.
refs.Add("C:\WINNT\system32\msmask32.ocx")
' Adds a reference to System.dll as an example of adding a
' reference using just the simple name.
refs.Add("System")
End Sub