VSProject.AddWebReference(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет ссылку на веб-службу этого проекта. В папку веб-ссылок проекта добавляется новая вложенная папка ссылок на веб-службу. В этой новой папке содержится несколько других элементов проекта, относящихся к веб-службе. Метод возвращает объект ProjectItem, связанный с новой папкой веб-службы.
public:
EnvDTE::ProjectItem ^ AddWebReference(System::String ^ bstrUrl);
public:
EnvDTE::ProjectItem ^ AddWebReference(Platform::String ^ bstrUrl);
EnvDTE::ProjectItem AddWebReference(std::wstring const & bstrUrl);
[System.Runtime.InteropServices.DispId(7)]
public EnvDTE.ProjectItem AddWebReference (string bstrUrl);
[<System.Runtime.InteropServices.DispId(7)>]
abstract member AddWebReference : string -> EnvDTE.ProjectItem
Public Function AddWebReference (bstrUrl As String) As ProjectItem
Параметры
- bstrUrl
- String
Обязательный. Обычно это URL-адрес имени файла с расширением DISCO или VSDISCO.
Возвращаемое значение
Возвращает объект ProjectItem, являющийся новой папкой веб-ссылок.
- Атрибуты
Примеры
[Visual Basic]
' 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( _
"http://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
Комментарии
Если WebReferencesFolder имеет значение Nothing ( null ссылка), то ProjectItem создается папка для веб-ссылок проекта и WebReferencesFolder задается.
При создании веб-ссылки на веб-службу в ProjectItem коллекцию проекта добавляется новый тип папки, ProjectItems . Этот новый ProjectItem содержит, в своем ProjectItems свойстве, отдельные элементы, которые составляют спецификацию веб-ссылки. В следующей таблице описаны четыре типа элементов, входящих в спецификацию веб-ссылок.
| Элемент | Назначение |
|---|---|
| Файл отображения (ссылка. Map) | Этот XML-файл сопоставляет URL-адреса с расположением локального кэшированного файла. В нем содержится список файлов обнаружения и контрактов служб для веб-службы. |
| Файлы контрактов службы (WSDL) | Эти файлы SOAP указывают интерфейс веб-службы. В папке веб-ссылок может быть несколько файлов контрактов. |
| Файлы определения схемы XML (. xsd) | Эти файлы содержат определения схемы XML для веб-службы. В папке веб-ссылок может быть несколько файлов схемы. |
| Файл обнаружения (. DISCO или. всдиско) | Этот XML-файл содержит ссылки на другие ресурсы, описывающие веб-службу. |