VSProject.AddWebReference (Método)
Agrega al proyecto una referencia a un servicio Web. Se agrega una nueva subcarpeta con una referencia a un servicio Web a la carpeta Referencias web del proyecto. Esta nueva carpeta contiene otros elementos de proyecto relacionados con el servicio Web. El método devuelve el objeto ProjectItem asociado a la nueva carpeta de servicio Web.
Espacio de nombres: VSLangProj
Ensamblado: VSLangProj (en VSLangProj.dll)
Sintaxis
'Declaración
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
Obligatorio.Normalmente, se trata de una dirección URL de archivo con extensión .disco o .vsdisco.
Valor devuelto
Tipo: EnvDTE.ProjectItem
Devuelve un objeto ProjectItem que es la nueva carpeta Referencias web.
Comentarios
Si WebReferencesFolder es Nothing (una referencia nullreferencia null (Nothing en Visual Basic) ), se crea un ProjectItem para la carpeta Referencias Web para el proyecto y se establece la propiedad WebReferencesFolder.
Cuando se crea una referencia Web a un servicio Web, se agrega un nuevo tipo de carpeta, ProjectItem, a la colección ProjectItems del proyecto. Este nuevo objeto ProjectItem contiene, en su propiedad ProjectItems, los elementos individuales que componen una especificación de referencia Web. Los cuatro tipos de elementos incluidos en una especificación de referencia Web se describen en la tabla siguiente.
Elemento |
Finalidad |
|---|---|
Archivo de asignación (Reference.map) |
Este archivo XML asigna las direcciones URL a la ubicación local de archivos almacenados en caché. Enumera el archivo de descubrimiento y los archivos de contrato de servicios del servicio Web. |
Archivos de Contrato de servicios (.wsdl) |
Estos archivos SOAP especifican la interfaz del servicio Web. Puede haber más de un archivo de contrato en la carpeta Web Reference. |
Archivos de definición de esquema XML (.xsd) |
Estos archivos contienen definiciones de esquemas XML para el servicio Web. Puede haber más de un archivo de esquema en la carpeta Web Reference. |
Archivo de descubrimiento (.disco o .vsdisco) |
Este archivo XML contiene vínculos a otros recursos que describen el servicio Web. |
Ejemplos
[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
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.