VSProject.AddWebReference-Methode

Artikel
08/20/2007

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
'Usage

Parameter

bstrUrl
Erforderlich. In der Regel handelt es sich dabei um den Dateinamen-URL mit der Erweiterung .disco oder .vsdisco.

Rückgabewert

Gibt ein ProjectItem-Objekt zurück, das den neuen Ordner Webverweise darstellt.

Hinweise

Wenn die WebReferencesFolder-Eigenschaft Nothing (NULL (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 Verknüpfungen zu anderen Ressourcen, die den Webdienst beschreiben.

Beispiel

' 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

Siehe auch

Referenz

VSProject-Schnittstelle
VSProject-Member
VSLangProj-Namespace

Freigeben über