VSProject.AddWebReference - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Добавляет ссылку на веб-службу этого проекта. В папку веб-ссылок данного проекта добавляется новая вложенная папка ссылок на веб-службы. В этой новой папке содержится несколько других элементов проекта, относящихся к веб-службе. Этот метод возвращает объект ProjectItem, связанный с новой папкой веб-службы.

Пространство имен: VSLangProj
Сборка: VSLangProj (в VSLangProj.dll)

Синтаксис

'Декларация
Function AddWebReference ( _
    bstrUrl As String _
) As ProjectItem
'Применение
Dim instance As VSProject
Dim bstrUrl As String
Dim returnValue As ProjectItem

returnValue = instance.AddWebReference(bstrUrl)

ProjectItem AddWebReference(
    string bstrUrl
)

ProjectItem^ AddWebReference(
    [InAttribute] String^ bstrUrl
)

function AddWebReference(
    bstrUrl : String
) : ProjectItem

Параметры

bstrUrl
Тип: System.String
Обязательный. Обычно это URL-адрес имени файла с расширением .disco или .vsdisco.

Возвращаемое значение

Тип: EnvDTE.ProjectItem
Возвращает объект ProjectItem, представляющий новую папку веб-ссылок проекта.

Заметки

Если параметр WebReferencesFolder имеет значение Nothing (ссылка nullссылка null (Nothing в Visual Basic) (Nothing в Visual Basic)), то создается элемент ProjectItem для папки веб-ссылок проекта, и параметр WebReferencesFolder устанавливается.

При создании веб-ссылки на веб-службу в коллекцию ProjectItems проекта добавляется новый тип папки ProjectItem. В свойстве ProjectItems этого нового объекта ProjectItem содержатся отдельные элементы, составляющие спецификацию веб-ссылки. В следующей таблице описаны четыре типа элементов, включенных в спецификацию веб-ссылки.

Элемент	Назначение
Файл сопоставления (Reference.map)	Данный XML-файл сопоставляет URL-адреса с локальным расположением кэшированного файла. В нем перечислены файл обнаружения и файлы контрактов служб для данной веб-службы.
Файлы контрактов служб (WSDL-файлы)	В этих SOAP-файлах задается интерфейс данной веб-службы. В папке веб-ссылок может быть несколько файлов контрактов служб.
Файлы определения схемы XML (XSD-файлы)	В этих файлах содержатся определения схемы XML для данной веб-службы. В папке веб-ссылок может быть несколько файлов схем.
Файл обнаружения (DISCO- или VSDISCO-файлы)	В этом XML-файле содержатся ссылки на другие ресурсы, описывающие данную веб-службу.

Примеры

' 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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

VSProject Интерфейс

VSProject - члены

VSLangProj - пространство имен

Поделиться через