Método VSProject2.AddWebReference

Artigo
05/17/2015

Adiciona uma referência a um serviço Web ao projeto. Uma nova subpasta da referência do 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 objeto de ProjectItem associado à nova pasta do serviço Web.

Namespace: VSLangProj80
Assembly: VSLangProj80 (em VSLangProj80.dll)

Sintaxe

'Declaração
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

Parâmetros

bstrUrl
Tipo: String

Necessário. Normalmente, esse é uma URL de nome de arquivo com uma extensão de .disco ou de .vsdisco.

Valor de retorno

Tipo: ProjectItem
Retorna um objeto de ProjectItem que é a nova pasta de referência da Web.

Comentários

Se WebReferencesFolder é Nothing (uma referência de nulluma referência nula (Nothing no Visual Basic) ), então ProjectItem para Web faz referência à pasta para o projeto é criado e WebReferencesFolder é definido.

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

Item	Finalidade
Arquivo de mapa (Reference.map)	As urls de mapas desse arquivo XML para o local armazenado em cachê o arquivo local. 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 de SOAP especificam a interface de serviço Web. Pode haver mais de um arquivo do contrato na pasta de referência da Web.
O XSD de programas (.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)	Esse arquivo XML contém links para outros recursos que descrevem o serviço Web.

Exemplos

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

[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( _
    "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

[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
("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.
    MessageBox.Show("Number of items in the Web Reference folder: \n"
 + newFolder.ProjectItems.Count.ToString());
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

VSProject2 Interface

Namespace VSLangProj80

Partilhar via