Referencias Web y Clases personalizadas de proxy cliente de servicios Web en las bibliotecas de clases

Actualización: noviembre 2007

En el Diseñador de aplicaciones, puede representar referencias Web a servicios Web o a clases personalizadas de proxy cliente de servicios Web que están definidas en proyectos o ensamblados de referencia como extremos de consumidor de servicios Web en aplicaciones Windows, Office o ASP.NET. Para llevar a cabo esta tarea, debe realizar ciertos pasos para mostrar estos elementos como tipos "indirectos" de conexiones a los extremos de consumidor de servicios Web.

Nota:
No puede agregar directamente los extremos del consumidor de servicios Web para representar estos elementos conectando la aplicación de consumidor a un extremo del proveedor de servicios Web y moviendo estos elementos a una biblioteca de clases.

Sin embargo, antes de realizar estos pasos, se debe implementar la aplicación de consumidor de servicios Web y el proyecto de aplicación debe contener un archivo de configuración de aplicación (Web.config o App.config). Para obtener más información, vea Implementar aplicaciones en diagramas de aplicaciones.

Requisitos para realizar la ingeniería inversa en referencias Web y clases personalizadas de proxy cliente de servicios Web en las bibliotecas de clases

En las aplicaciones ASP.NET, debe agregar las entradas apropiadas al archivo de configuración Web.config, y deben existir y encontrarse las clases de proxy con nombres completos y coincidentes. Sin embargo, en las aplicaciones para Windows y Office, es suficiente la existencia de tales entradas en el archivo de configuración App.config y su designación como tipo WebServiceURL. Sin embargo, si estas entradas no están designadas con el tipo WebServiceURL, o si están designadas con el tipo String, en este caso también deben existir y encontrarse las clases de proxy con nombres completos y coincidentes. Para obtener más información, vea Consideraciones referentes a las clases personalizadas de proxy cliente de servicios Web.

Cuando una aplicación de consumidor de servicios Web hace referencia a bibliotecas de clases que definen referencias Web o clases personalizadas de proxy cliente de servicios Web, debe agregarse una referencia de proyecto a esa biblioteca de clases al proyecto de aplicación de consumidor de servicios Web. Sin embargo, la configuración del archivo de configuración del proyecto de aplicación reemplaza a la del archivo de configuración de la biblioteca de clases. Por consiguiente, para utilizar la configuración creada en el archivo de configuración de la biblioteca de clases, debe copiarla en el archivo de configuración de la aplicación de consumidor. Para obtener más información, vea Cómo: Hacer referencia a las bibliotecas de clases de aplicaciones en diagramas de aplicaciones.

Cuando se cumplen estos requisitos, el Diseñador de aplicaciones realiza la ingeniería inversa de estas entradas del archivo de configuración como extremos de consumidor de servicios Web. Además, si las direcciones URL de servicios Web especificadas en estas entradas coinciden con las direcciones URL de los extremos del proveedor de servicios Web, también aparecen las conexiones entre estos extremos del proveedor y del consumidor. Si no existe ningún extremo del proveedor de servicios Web coincidente, pero la dirección URL se puede utilizar para buscar un archivo WSDL válido para el servicio Web adjuntando "?wsdl" o "?disco" a la dirección URL, en este caso se agrega el servicio Web externo al diagrama de aplicaciones y se conecta al extremo de consumidor de servicios Web. Si no se puede buscar un archivo WSDL utilizando la dirección URL, el extremo de consumidor de servicios Web permanece sin conectar.

Cambios que afectan a los extremos de consumidor de servicios Web indirectos

La realización de ciertos cambios puede afectar a los extremos de consumidor de servicios Web indirectos y a sus conexiones de la manera siguiente:

• La creación o eliminación de conexiones en los extremos de consumidor de servicios Web desde el diagrama de aplicaciones agrega o quita la dirección URL del servicio Web conectado desde el archivo de configuración de la aplicación de consumidor.

• La eliminación de extremos de consumidor de servicios Web indirectos del diagrama de aplicaciones elimina las entradas correspondientes del archivo de configuración pero no las referencias Web o las clases personalizadas de proxy de las bibliotecas de clases.

  Nota:
  Si elimina un extremo indirecto, asegúrese de que la aplicación o cualquier biblioteca de clases de referencia ya no hace referencia a la entrada correspondiente del archivo de configuración.

• La eliminación o el cambio de nombre de una clase de proxy en un proyecto o el ensamblado al que hace referencia una aplicación ASP.NET quita el extremo de consumidor de servicios Web correspondiente.

  Este resultado aparece porque la entrada del archivo de configuración ya no coincide con una clase de proxy. Volver a agregar una clase de proxy con un nombre coincidente hace que vuelva a aparecer el extremo de consumidor.

• Copiar y pegar extremos de consumidor de servicios Web cuyas referencias Web residen en una biblioteca o ensamblado de clases hace que aparecen las referencias a los extremos pegados en el proyecto raíz.

Vea también

Referencia

Consideraciones referentes a las clases personalizadas de proxy cliente de servicios Web

Otros recursos

Hacer referencia a las bibliotecas de clases de aplicaciones en diagramas de aplicaciones