VSProject.AddWebReference-Methode
Fügt dem Projekt einen Verweis auf einen Webdienst hinzu. Im Ordner Webverweise des Projekts wird ein neuer Unterordner Webdienste angelegt. Dieser neue Ordner enthält mehrere weitere zum Webdienst gehörige Projektelemente. Die Methode gibt das dem neuen Webdienstordner zugeordnete ProjectItem-Objekt zurück.
Namespace: VSLangProj
Assembly: VSLangProj (in VSLangProj.dll)
Syntax
'Declaration
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
Parameter
- bstrUrl
Typ: System.String
Erforderlich.In der Regel handelt es sich dabei um die Dateinamen-URL mit der Erweiterung .disco oder .vsdisco.
Rückgabewert
Typ: EnvDTE.ProjectItem
Gibt ein ProjectItem-Objekt zurück, das den neuen Ordner Webverweise darstellt.
Hinweise
Wenn die WebReferencesFolder-Eigenschaft Nothing (nullNULL-Verweis (Nothing in Visual Basic)-Verweis) lautet, wird ein ProjectItem-Objekt für den Ordner Webverweise des Projekts erstellt und die WebReferencesFolder-Eigenschaft festgelegt.
Beim Erstellen eines Webverweises auf einen Webdienst wird der ProjectItems-Auflistung des Projekts ein neues ProjectItem-Objekt in Form eines Ordners hinzugefügt. Dieses neue ProjectItem enthält in seiner ProjectItems-Eigenschaft die einzelnen Elemente, aus denen die Webverweisspezifikation besteht. In der folgenden Tabelle werden die vier in einer Webverweisspezifikation enthaltenen Elementtypen aufgeführt.
Element |
Zweck |
|---|---|
Zuordnungsdatei (Reference.map) |
Diese XML-Datei ordnet den im Cache zwischengespeicherten lokalen Dateipositionen URLs zu. Sie führt die Discovery-Datei und die Vertragsdateien für den Webdienst auf. |
Vertragsdateien (.wsdl) |
Diese SOAP-Dateien legen die Schnittstelle des Webdienstes fest. Im Ordner Webverweise können sich mehrere Vertragsdateien befinden. |
XML Schema Definition-Dateien (.xsd) |
Diese Dateien enthalten XML-Schemadefinitionen für den Webdienst. Im Ordner Webverweise können sich mehrere Schemadateien befinden. |
Discovery-Datei (.disco oder .vsdisco) |
Diese XML-Datei enthält Links zu anderen Ressourcen, die den Webdienst beschreiben. |
Beispiele
[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-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.