VSProject.AddWebReference - метод
Обновлен: Ноябрь 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
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.