Método VSProject.AddWebReference

Artigo
08/01/2011

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: VSLangProj
Assembly: VSLangProj (em VSLangProj.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.

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.

Item	Purpose
Arquivo de mapa (Reference.map)	Este arquivo XML mapeia os URLs para o local do arquivo de cache local. Ele lista o arquivo de descoberta e os arquivos de contrato de serviço do serviço da Web.
Arquivos de contrato de serviço (. WSDL)	Esses arquivos SOAP especificam a interface do serviço da Web. Pode haver mais de um arquivo do contrato na pasta 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 da Web. Pode haver mais de um arquivo de esquema na pasta referência da Web.
Arquivo de descoberta (incluíndo ou. vsdisco)	Esse arquivo XML contém links para outros recursos que descrevem o serviço da Web.

Exemplos

[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

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

VSProject Interface

Namespace VSLangProj

Compartilhar via