Considerations for Refreshing Web References on Application Diagrams

  • Article

In Application Designer, a Web reference is generated for each Web service consumer endpoint on a Web service consumer application upon implementation, if it supports implementation. This Web reference is associated with the corresponding Web service and is generated when a valid WSDL file is available. For more information, see Overview of ASP.NET Applications on Application Diagrams.

With the exception of the scenarios described in this topic, Web references associated with a Web service implemented in the solution are updated automatically when changes made to the Web service definition, for example, to its operations or parameters, are saved. You can save these changes by saving the solution or the Web service class file that contains the Web service operation definitions.

The following scenarios require you to manually update Web references:

  • Changes to the WSDL file for an external or BizTalk Web service.

  • Changes to custom-defined types referenced by a Web service on an ASP.NET application.

  • Changes to the WSDL properties and attributes, such as the WSDL binding name and namespace.

You must manually update each Web reference to a Web service on an ASP.NET application. You can update all Web references to an external or BizTalk Web service by refreshing that Web service.

For more information, see the following topics:

When updating Web references to Web services, be aware of the following considerations:

  • Web references associated with a Web service created from a WSDL or DISCO file cannot be updated if the file is invalid or missing.

    Note

    WSDL files containing multiple WSDL bindings or DISCO files that reference multiple Web services are not supported.

  • If you want to update a Web reference for a Web service consumer endpoint that is connected to a Web service with a different WSDL location, you must first delete the connection between the two endpoints, reconnect those endpoints, and then choose to update the Web reference from the provider endpoint. For more information, see How to: Reconnect Web Services on Application Diagrams.

See Also

Concepts

Web Service Endpoints Based on WSDL Files

Other Resources

Refreshing Web Services and Web References on Application Diagrams