VSProject.AddWebReference(String) Methode

Definition

Fügt dem Projekt einen Verweis auf einen Webdienst hinzu. Ein neuer Unterordner des Webdienst Verweises wird dem Ordner "Web References" des Projekts hinzugefügt. Dieser neue Ordner enthält mehrere weitere Projekt Elemente, die mit dem Webdienst verknüpft sind. Die-Methode gibt das-Objekt zurück, das ProjectItem dem neuen Webdienst Ordner zugeordnet ist.

public:
 EnvDTE::ProjectItem ^ AddWebReference(System::String ^ bstrUrl);
public:
 EnvDTE::ProjectItem ^ AddWebReference(Platform::String ^ bstrUrl);
EnvDTE::ProjectItem AddWebReference(std::wstring const & bstrUrl);
[System.Runtime.InteropServices.DispId(7)]
public EnvDTE.ProjectItem AddWebReference (string bstrUrl);
[<System.Runtime.InteropServices.DispId(7)>]
abstract member AddWebReference : string -> EnvDTE.ProjectItem
Public Function AddWebReference (bstrUrl As String) As ProjectItem

Parameter

bstrUrl
String

Erforderlich. In der Regel handelt es sich hierbei um eine Datei namens-URL mit der Erweiterung. disco oder. vsdisco.

Gibt zurück

ProjectItem

Gibt ein- ProjectItem Objekt zurück, das der neue Webverweis Ordner ist.

Attribute

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( _  
   "http://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  

Hinweise

Wenn WebReferencesFolder Nothing (ein null Verweis) ist, ProjectItem wird ein für den Ordner Webverweise für das Projekt erstellt, und der WebReferencesFolder wird festgelegt.

Wenn ein Webverweis auf einen Webdienst erstellt wird, wird der Projekt Auflistung ein neuer Ordnertyp ProjectItem hinzugefügt ProjectItems . Diese neue ProjectItem enthält in der- ProjectItems Eigenschaft die einzelnen Elemente, die eine Webverweis Spezifikation bilden. Die vier Typen von Elementen, die in einer Webverweis Spezifikation enthalten sind, werden in der folgenden Tabelle beschrieben.

Element Zweck
Zuordnungs Datei (Reference. map) Diese XML-Datei ordnet URLs dem Speicherort der lokalen zwischengespeicherten Datei zu. Sie listet die Ermittlungs Datei und die Dienstvertrags Dateien für den Webdienst auf.
Dienstvertrags Dateien (. WSDL) Diese SOAP-Dateien geben die-Schnittstelle des Webdiensts an. Im Webverweis Ordner sind möglicherweise mehrere Vertrags Dateien vorhanden.
XML-Schema Definitions Dateien (. xsd) Diese Dateien enthalten XML-Schema Definitionen für den Webdienst. Im Webverweis Ordner sind möglicherweise mehrere Schema Dateien vorhanden.
Ermittlungs Datei (. disco oder. vsdisco) Diese XML-Datei enthält Links zu anderen Ressourcen, die den Webdienst beschreiben.

Gilt für