Compartir a través de

Cómo: Definir operaciones para los servicios web ASP.NET

  • Artículo

Actualización: noviembre 2007

En el Diseñador de aplicaciones y el Diseñador de sistemas, puede definir las operaciones de un punto final de proveedor de servicios web .NET. Para ello, utilice la ventana Detalles del servicio web. Para obtener más información, vea Información general sobre aplicaciones ASP.NET en diagramas de aplicaciones.

Sugerencia:

Puede crear un punto final de proveedor de servicios web .NET con firmas y tipos de operación predefinidos especificando un archivo WSDL o .disco. A continuación, podrá ver o editar estas operaciones en la ventana Detalles del servicio web. Para obtener más información, vea Cómo: Agregar extremos a aplicaciones.

Al definir las operaciones de un punto final de proveedor de servicios web .NET, los define para todos los usos de ese punto final. Después de definir estas operaciones, podrá editarlas en cualquier momento en la ventana Detalles del servicio web. Después de implementar una aplicación ASP.NET con un punto final de proveedor de servicios web .NET, podrá editar las operaciones del punto final mediante la ventana Detalles del servicio web o mediante código, que se mantienen sincronizados. Para obtener más información, vea Cómo: Editar operaciones para los servicios web ASP.NET.

Nota:

Un proyecto de aplicación ASP.NET contiene un archivo de clase de servicio web para cada punto final de proveedor de servicios web de la aplicación. Cada archivo de clase del servicio Web contiene las firmas de la operación para el extremo del proveedor de servicios Web correspondiente. Cada firma de la operación, junto con los comentarios, aparece como un método con el atributo WebMethod en el archivo de clase del servicio Web. Puede agregar el código de cuerpo de método adecuado para completar la implementación de cada operación.

Para definir una operación del servicio Web

  1. En el diagrama, seleccione un punto final de proveedor de servicios web.

  2. En el menú Diagrama, elija Definir operaciones.

    Sugerencia:

    También puede hacer clic con el botón secundario del mouse en el extremo y elegir Definir operaciones.

    Aparece la ventana Detalles del servicio Web.

  3. En la fila de la operación en la ventana Detalles del servicio Web, haga clic en <agregar operación> debajo de Nombre y dé un nombre a la operación.

  4. En la misma fila debajo de Tipo, especifique el tipo de valor devuelto de la operación, si es necesario. Si no es necesario especificar ninguno, continúe en el paso 7.

    Nota:

    De forma predeterminada, la operación no devuelve ningún dato a menos que se defina explícitamente que lo haga. La representación de una operación que no devuelve ningún dato depende del lenguaje especificado para el servicio Web. Al utilizar Visual Basic, no se especifica ningún tipo de valor devuelto de la operación. Con Visual C#, el tipo predeterminado de valor devuelto para una operación es void. No se pueden serializar los tipos de interfaz y generarán un error al crear cualquier referencia Web conectada con el servicio Web.

  5. Para seleccionar un tipo, comience a escribir para ver la lista de tipos.

    A medida que escribe, se abre la lista y se muestran los tipos disponibles.

    Sugerencia:

    Si el tipo que busca no está en la lista de tipos, utilice el nombre de tipo completo, especifique un tipo definido en otro proyecto o biblioteca de tipos o especifique un nuevo tipo para definirlo después de la implementación. Para terminar de especificar el tipo, siga escribiendo el nombre del tipo que desea.

  6. Salga de la celda presionando ENTRAR o haciendo clic en otra celda.

    Nota:

    Al presionar la tecla TAB, se reemplaza el tipo especificado con el tipo coincidente más cercano en la lista de tipos.

  7. En Resumen, agregue comentarios sobre la operación.

    Sugerencia:

    Para agregar más información, haga clic en el botón de puntos suspensivos (…) para abrir el cuadro de diálogo Descripción. Ahora puede especificar comentarios adicionales relativos a la descripción de WSDL, al tipo de valor devuelto de la operación o cualquier otro comentario, si lo hubiera. La información de descripción de WSDL especificada aparece en el archivo WSDL.

Antes de implementar una aplicación ASP.NET, la lista de tipos muestra sólo los tipos definidos en la biblioteca principal de Microsoft (MSCorLib.dll) además de algunas otras bibliotecas de tipos a las que se hace referencia implícitamente. Sin embargo, puede hacer referencia a tipos definidos en otras bibliotecas y proyectos de tipos, o puede hacer referencia a tipos que piensa definir posteriormente en código o utilizando el Diseñador de clases cuando se haya implementado la aplicación.

Si hace referencia a tipos que están definidos en otros proyectos o bibliotecas de tipos, debe agregar referencias a esos proyectos o bibliotecas cuando se haya implementado la aplicación. La lista de tipos incluirá todos los tipos definidos en todos los proyectos y bibliotecas de tipos a los que se ha hecho referencia implícitamente. Para obtener más información, vea Cómo: Agregar y quitar referencias en Visual Studio (C#).

Si hace referencia a tipos que piensa definir más adelante, estos tipos no aparecen en la lista de tipos hasta que agregue un archivo de clases o un diagrama de clase al proyecto de aplicación para definir el tipo una vez se haya implementado la aplicación. Para obtener más información, vea Cómo: Definir tipos de operación y de parámetro para servicios web ASP.NET.

Después de definir una operación, puede definir sus parámetros o cualquier otra operación en la siguiente fila de la operación.

Para definir parámetros para una operación de servicio Web

  1. En la ventana Detalles del servicio Web, expanda el nodo de operación.

  2. En la fila de parámetros que se encuentra debajo de la operación, haga clic en <agregar el parámetro> debajo de Nombre y dé un nombre al parámetro.

    Sugerencia:

    Elija un nombre de parámetro único en la operación.

  3. En Tipo, especifique el tipo de parámetro si es necesario.

  4. En Modificador, seleccione cómo pasar el parámetro.

  5. En Resumen, agregue comentarios sobre el parámetro.

    Sugerencia:

    Para agregar más información, haga clic en el botón de puntos suspensivos (…) para abrir el cuadro de diálogo Descripción.

Después de definir un parámetro, puede definir un nuevo parámetro en la siguiente fila de parámetros. También puede definir un parámetro a través de sus propiedades en la ventana Propiedades.

Vea también

Tareas

Cómo: Especificar operaciones unidireccionales o de solicitud y respuesta para servicios web ASP.NET

Cómo: Editar operaciones para los servicios web ASP.NET

Cómo: Eliminar operaciones y parámetros de servicios web ASP.NET

Referencia

Métodos abreviados de teclado para la ventana de detalles de servicios web

Otros recursos

Definir operaciones para servicios web ASP.NET