VSProject.AddWebReference 方法
將 Web 服務的參考加入至專案。新的 Web 服務參考子資料夾會加入至專案的 Web 參考資料夾。這個新的資料夾包含幾個與 Web 服務相關的其他專案項目。這個方法會傳回與新 Web 服務資料夾關聯的 ProjectItem 物件。
命名空間: VSLangProj
組件： VSLangProj (在 vslangproj.dll 中)
語法
'宣告
'用途
參數
- bstrUrl
必要項。這通常是具有 .disco 或 .vsdisco 副檔名的檔名 URL。
傳回值
傳回代表 Web 參考資料夾的 ProjectItem 物件。
備註
如果 WebReferencesFolder 是 Nothing (Null 參照 (即 Visual Basic 中的 Nothing) 參考)，便會建立專案 Web 參考資料夾的 ProjectItem，也會設定 WebReferencesFolder。
當建立 Web 服務的 Web 參考時，新的資料夾類型的 ProjectItem 會加入至專案的 ProjectItems 集合。這個新的 ProjectItem 在其 ProjectItems 屬性中包含組成 Web 參考規格的個別項目。下列資料表將說明包含在 Web 參考規格中的四種項目類型。
項目 |
用途 |
|---|---|
對應檔 (Reference.map) |
這個 XML 檔將 URL 對應至本機快取的檔案位置。它會列出 Web 服務的探索檔以及服務合約檔。 |
服務合約檔 (.wsdl) |
這些 SOAP 檔案指定 Web 服務的介面。Web 參考資料夾中可能有一個以上的合約檔。 |
XML 結構描述定義檔 (.xsd) |
這些檔案包含 Web 服務的 XML 結構描述 (Schema) 定義。Web 參考資料夾中可能有一個以上的結構描述檔。 |
探索檔 (.disco 或 .vsdisco) |
這個 XML 檔包含說明 Web 服務的其他資源連結。 |
範例
' Macro Editor
Imports VSLangProj
Sub AddWebReferenceExample()
' 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)
' The new project item is a folder.
Dim newFolder As ProjectItem
newFolder = aVSProject.AddWebReference( _
"https://ServerName/Application/myServiceName.asmx")
' The new name of the folder appears in Solution Explorer.
newFolder.Name = "NewName"
' The ProjectItems collection for the folder is not empty.
MsgBox(newFolder.ProjectItems.Count.ToString())
End Sub