Metodo VSProject.AddWebReference

Articolo
08/22/2007

Aggiunge un riferimento ad un servizio Web nel progetto. Viene aggiunta una nuova sottocartella di riferimento del servizio Web alla cartella Web References del progetto. Questa nuova cartella contiene numerosi altri elementi del progetto relativi al servizio Web. Il metodo restituisce l'oggetto ProjectItem associato alla nuova cartella del servizio Web.

Spazio dei nomi: VSLangProj
Assembly: VSLangProj (in vslangproj.dll)

Sintassi

'Dichiarazione
'Utilizzo

Parametri

bstrUrl
Obbligatorio. Normalmente si tratta dell'URL di un file il cui nome ha estensione DISCO o VSDISCO.

Valore restituito

Restituisce un oggetto ProjectItem che è la nuova cartella dei riferimenti Web.

Note

Se la proprietà WebReferencesFolder è Nothing, ovvero un riferimento riferimento null (Nothing in Visual Basic), viene creato un elemento ProjectItem per la cartella dei riferimenti Web del progetto e viene impostata la proprietà WebReferencesFolder.

Quando viene creato un riferimento Web per un servizio Web, viene aggiunto un nuovo tipo di cartella, ProjectItem, all'insieme ProjectItems del progetto. Questo nuovo ProjectItem contiene, nella sua proprietà ProjectItems, i singoli elementi che costituiscono una specifica del riferimento Web. I quattro tipi di elementi compresi nella specifica di un riferimento Web sono descritti nella tabella seguente.

Elemento	Funzione
File MAP (Reference.map)	Questo file XML effettua il mapping degli URL alla posizione locale del file memorizzato nella cache. Elenca il file di individuazione e i file del contratto di servizio per il servizio Web.
File del contratto di servizio (WSDL)	Questi file SOAP specificano l'interfaccia del servizio Web. Nella cartella dei riferimenti Web può esistere più di un file di contratto.
File di definizione schema XML (XSD)	Questi file contengono le definizioni di schema XML per il servizio Web. Nella cartella dei riferimenti Web può esistere più di un file di schema.
File di individuazione (DISCO o VSDISCO)	Questo file XML contiene i collegamenti ad altre risorse che descrivono il servizio Web.

Esempio

' 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

Vedere anche

Riferimenti

Interfaccia VSProject
Membri VSProject
Spazio dei nomi VSLangProj

Condividi tramite