VSProject.AddWebReference, méthode

Article
08/10/2011

Ajoute au projet une référence à un service Web. Un nouveau sous-dossier de référence à un service Web est ajouté au dossier Web References du projet. Ce nouveau dossier contient plusieurs autres éléments de projet relatifs au service Web. La méthode retourne l'objet ProjectItem associé au nouveau dossier de service Web.

Espace de noms : VSLangProj
Assembly : VSLangProj (dans VSLangProj.dll)

Syntaxe

'Déclaration
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

Paramètres

bstrUrl
Type : System.String
Obligatoire.En général, il s'agit d'une URL de nom de fichier dotée de l'extension .disco ou .vsdisco.

Valeur de retour

Type : EnvDTE.ProjectItem
Retourne un objet ProjectItem qui est le nouveau dossier Web Reference.

Notes

Si WebReferencesFolder a la valeur Nothing (référence nullune référence null (Nothing en Visual Basic)), ProjectItem est créé pour le dossier Web References du projet et WebReferencesFolder est défini.

Quand une référence Web à un service Web est créée, un nouveau type de dossier, ProjectItem, est ajouté à la collection ProjectItemsdu projet. Le nouveau ProjectItem contient, dans sa propriété ProjectItems, les différents éléments constituant une spécification de référence Web. Les quatre types d'éléments inclus dans une spécification de référence Web sont décrits dans le tableau suivant.

Élément	Objectif
Fichier de mappage (Reference.map)	Ce fichier XML mappe les URL avec l'emplacement de fichier de cache local. Il affiche le fichier de découverte et les fichiers de contrat de service du service Web.
Fichiers de contrat de service (.wsdl)	Ces fichiers SOAP spécifient l'interface du service Web. Le dossier Web Reference peut contenir plusieurs fichiers de contrat.
Fichiers de définition de schéma XML (.xsd)	Ces fichiers contiennent les définitions de schéma XML du service Web. Le dossier Web Reference peut contenir plusieurs fichiers de schéma.
Fichier de découverte (.disco ou .vsdisco)	Ce fichier XML contient des liens vers d'autres ressources décrivant le service Web.

Exemples

[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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

VSProject Interface

VSLangProj, espace de noms

Partager via