Método VSProject2.AddWebReference (String)

Adiciona uma referência a um serviço Web ao projeto. Uma nova subpasta de referência de serviço da Web é adicionada à pasta de referências da Web do projeto. Essa nova pasta contém vários outros itens de projeto relacionados ao serviço da Web. O método retorna o ProjectItem objeto associado a nova pasta de serviço da 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: System.String
  Required.Normalmente, isso é uma URL de nome de arquivo com uma extensão. disco ou. vsdisco.

Valor de retorno

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

Implementações

VSProject.AddWebReference(String)

Comentários

Se o WebReferencesFolder é Nothing (um nulluma referência nula (Nothing no Visual Basic) referência), e em seguida, um ProjectItem para as referências da Web a pasta para o projeto é criada e o WebReferencesFolder está definido.

Quando uma referência da Web a um serviço Web é criada um novo tipo de pasta, ProjectItem, é adicionado ao projeto ProjectItems coleção. Essa nova ProjectItem contém, sua ProjectItems propriedade, os itens individuais que compõem 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.

Exemplos

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

[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áveis.

Consulte também

Referência

VSProject2 Interface

Sobrecargas AddWebReference

Namespace VSLangProj80