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 ProjectItemo objeto associado com a nova pasta de 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: System.String
Necessário.Normalmente, isso é um nome de arquivo URL com uma extensão. disco ou. vsdisco.
Valor de retorno
Tipo: EnvDTE.ProjectItem
Retorna um ProjectItemo objeto que é a nova pasta de referência Web .
Comentários
Se a WebReferencesFolder é Nothing (um nulluma referência nula (Nothing no Visual Basic) referência), e em seguida, um ProjectItem para as referências Web pasta para o projeto é criada e o WebReferencesFolder está definida.
Quando uma referência Web a um serviço Web é criada, um novo tipo de pasta, ProjectItem, é adicionado ao projetodo ProjectItems coleção. Essa nova ProjectItem contém, no seu 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 |
Objetivo |
---|---|
Arquivo de mapa (referência.mapa) |
Este arquivo XML mapeia os URLs para o local do arquivo em cache local.Ela 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 da Web .Pode haver mais de um arquivo do contrato na pasta de referência da Web . |
Arquivos de definição de esquema XML (. xsd) |
Esses arquivos contêm definições deesquema XMLpara o serviço Web . Pode haver mais de um arquivo de esquema na pasta de referência da Web . |
Arquivo de descoberta (incluíndo ou. vsdisco) |
Este arquivo XML contém links para outros recursos que descrevem o serviço Web . |
Exemplos
Este exemplo adiciona um web service para um Visual Basic ou Visual C# projeto. Antes de executar esse exemplo, substituir o bstrUrl parâmetro : https://ServerName/Application/myServiceName.asmx, com uma verdadeira URL. 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( _
"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.