VSProject.AddWebReference - метод

Статья
05/17/2015

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

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

Синтаксис

'Декларация
Function AddWebReference ( _
    bstrUrl As String _
) As ProjectItem

ProjectItem AddWebReference(
    string bstrUrl
)

ProjectItem^ AddWebReference(
    [InAttribute] String^ bstrUrl
)

abstract AddWebReference : 
        bstrUrl:string -> ProjectItem

function AddWebReference(
    bstrUrl : String
) : ProjectItem

Параметры

bstrUrl
Тип: String

Обязательный. Обычно это URL-адрес имени файла с расширением DISCO или VSDISCO.

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

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

Примеры

[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( _
   "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

Безопасность платформы .NET Framework

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

См. также

Ссылки

VSProject Интерфейс

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

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