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

Возвращает объект 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-файл содержит ссылки на другие ресурсы, описывающие веб-службу.

Применяется к