VSProject2.AddWebReference(String) Método

Definição

Adiciona uma referência a um serviço Web para o projeto. Uma nova subpasta referência de serviço Web é adicionada à pasta referências da Web do projeto. Essa nova pasta contém vários outros itens de projeto relacionados ao serviço Web. O método retorna o ProjectItem objeto associado à nova pasta de serviço da Web.

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

Parâmetros

bstrUrl
String

Obrigatórios. Normalmente, essa é uma URL de nome de arquivo com uma extensão. disco ou. vsdisco.

Retornos

ProjectItem

Retorna um ProjectItem objeto que é a nova pasta Web Reference.

Implementações

Atributos

Exemplos

Este exemplo adiciona um serviço Web a um Visual Basic projeto do ou do Visual C# . Antes de executar este exemplo, substitua o bstrUrl parâmetro: http://ServerName/Application/myServiceName.asmx , por uma URL real. Para executar este exemplo como um suplemento, consulte como compilar e executar os exemplos de código de modelo de objeto de automação.

[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());  
}  

Comentários

Se WebReferencesFolder for Nothing (uma null referência), um ProjectItem para a pasta de referências da Web para o projeto será criado e o WebReferencesFolder será definido.

Quando uma referência Web para um serviço Web é criada, um novo tipo de pasta, ProjectItem , é adicionado à coleção do projeto ProjectItems . Esse novo ProjectItem contém, em sua ProjectItems propriedade, os itens individuais que compõem uma especificação de referência Web. Os quatro tipos de itens incluídos em uma especificação de referência Web são descritos na tabela a seguir.

Item Finalidade
Arquivo de mapa (Reference. map) Esse arquivo XML mapeia URLs para o local do arquivo armazenado em cache local. Ele lista o arquivo de descoberta e os arquivos de contrato de serviço para o serviço Web.
Arquivos de contrato de serviço (. WSDL) Esses arquivos SOAP especificam a interface do serviço Web. Pode haver mais de um arquivo de contrato na pasta de referência da Web.
Arquivos de definição de esquema XML (. xsd) Esses arquivos contêm definições de esquema XML para o serviço Web. Pode haver mais de um arquivo de esquema na pasta de referência da Web.
Arquivo de descoberta (. disco ou. vsdisco) Este arquivo XML contém links para outros recursos que descrevem o serviço Web.

Aplica-se a