Metodo VSProject.AddWebReference
Aggiunge un riferimento ad un servizio Web nel progetto. Viene aggiunta una nuova sottocartella di riferimento del servizio Web alla cartella dei riferimenti Web 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
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
Parametri
- bstrUrl
Tipo: System.String
Obbligatorio.Normalmente si tratta dell'URL di un nome file con estensione .disco o .vsdisco.
Valore restituito
Tipo: EnvDTE.ProjectItem
Restituisce un oggetto ProjectItem che è la nuova cartella dei riferimenti Web.
Note
Se la proprietà WebReferencesFolder è Nothing, ovvero un riferimento nullriferimento 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 |
Scopo |
|---|---|
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 XML Schema (XSD) |
Questi file contengono le definizioni XML Schema 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. |
Esempi
[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
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.