VSProject2.AddWebReference(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Gibt ein- ProjectItem Objekt zurück, das der neue Webverweis Ordner ist.
Implementiert
- Attribute
Beispiele
In diesem Beispiel wird einem-oder-Projekt ein Webdienst hinzugefügt Visual Basic Visual C# . Ersetzen Sie vor dem Ausführen dieses Beispiels den- bstrUrl Parameter http://ServerName/Application/myServiceName.asmx durch eine tatsächliche URL. Informationen zum Ausführen dieses Beispiels als Add-in finden Sie unter Gewusst wie: Kompilieren und Ausführen der Code Beispiele für das Automatisierungs Objektmodell.
[Visual Basic]
' Add-in code.
Imports VSLangProj
Imports VSLangProj80
Public Sub OnConnection(ByVal application As Object,_
ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
applicationObject = CType(application, DTE2)
addInInstance = CType(addInInst, AddIn)
AddWebReferenceExample(applicationObject)
End Sub
Sub AddWebReferenceExample(ByVal dte As DTE2)
' This example assumes that the first project in the solution is
' a Visual Basic or C# project.
Dim aVSProject As VSProject2 = _
CType(applicationObject.Solution.Projects.Item(1).Object, _
VSProject2)
' The new project item is a folder.
Dim newFolder As ProjectItem
' Replace the sample URL with an actual URL.
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
[C#]
using System.Windows.Forms;
using VSLangProj;
using VSLangProj2;
using VSLangProj80;
public void OnConnection(object application, ext_ConnectMode
connectMode, object addInInst, ref Array custom)
{
applicationObject = (DTE2)application;
addInInstance = (AddIn)addInInst;
AddWebReferenceExample((DTE2)applicationObject);
}
public void AddWebReferenceExample(DTE2 dte)
{
// This example assumes that the first project in the solution is
// a Visual Basic or C# project.
VSProject2 aVSProject =
((VSProject2)( applicationObject.Solution.Projects.Item(1).Object));
// The new project item is a folder.
ProjectItem newFolder = null;
// Replace the sample URL with an actual URL.
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.
MessageBox.Show("Number of items in the Web Reference folder: \n"
+ newFolder.ProjectItems.Count.ToString());
}
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. |