Compartir a través de

Cómo: Deshabilitar la página de Ayuda del servicio de un servicio web

  • Artículo

Este tema es específico de una tecnología heredada. Ahora, los servicios Web XML y los clientes de servicios Web XML deben crearse con Windows Communication Foundation.

Al navegar en un explorador web a la dirección URL del servicio Web sin ningún parámetro se genera una página de ayuda HTML, si la página está habilitada (que es la forma predeterminada en el archivo machine.config de un servidor). La página de ayuda del servicio y su configuración se explican con más detalle en Configuración de opciones para los servicios web XML creados con ASP.NET.

Para deshabilitar la página de ayuda del servicio para una aplicación web individual

  1. Abra el archivo Web.config del directorio raíz de la aplicación web en su editor de texto favorito. (Si no existe el archivo Web.config, cree uno).

  2. Modifique la sección webServices de Web.config para quitar explícitamente el protocolo Documentation.

    <webServices>
     <protocols>
       <remove name="Documentation" />
     </protocols>
</webServices>

  3. Guarde el archivo Web.config.

    Este cambio de configuración se aplicará en la siguiente solicitud a un servicio Web hospedado por la aplicación web.

    2tyf2t8t.note(es-es,VS.100).gifNota:
    Al quitar el protocolo Documentation, también se deshabilita generación de archivos WSDL para cualquier servicio Web dentro de la aplicación web. Esto evita que los clientes generen una clase de proxy a menos que se cree y se proporcione un archivo WSDL personalizado para ellos. Para dejar la generación de archivos WSDL para los servicios Web dentro de una aplicación web, pero no proporcionar ninguna información legible humana relacionada con los servicios Web, puede agregar un elemento <wsdlHelpGenerator> al archivo Web.config para la aplicación web y establecer el atributo href a una página HTML en blanco que ha creado. El ejemplo de código siguiente es un fragmento de un archivo Web.config que establece la página de ayuda del servicio en un archivo MyBlank.htm en la carpeta docs bajo la carpeta que contiene el archivo Web.config. 

    <webServices>
   <wsdlHelpGenerator href="docs/MyBlank.htm"/>
</webServices>

Vea también

Tareas

Cómo: Deshabilitar la compatibilidad de protocolos para servicios web
Cómo: Habilitar la detección de servicios web XML

Conceptos

Configuración de opciones para los servicios web XML creados con ASP.NET
Implementar servicios web XML

Otros recursos

Servicios web XML con ASP.NET