VSProject.AddWebReference-Methode

Artikel
05/16/2015

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: String

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

Rückgabewert

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

Hinweise

Wenn die WebReferencesFolder-Eigenschaft Nothing (nullein Nullverweis (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.

Siehe auch

Referenz

VSProject Schnittstelle

VSLangProj-Namespace

Freigeben über