How to: Locate WSDL Files for Web Services 

  • Article

In Application Designer, you must specify the location of a WSDL file when you perform any of the following actions:

  • Add an external or BizTalk Web service to the application diagram. For more information, see How to: Define Applications on Application Diagrams and Application Types and Prototypes for Defining Applications.

  • Create a Web service provider endpoint on an ASP.NET application from a WSDL file. For more information, see How to: Add Endpoints to Applications and Overview of Endpoints on Applications.

  • Specify a different WSDL file for generating Web references to an implemented Web service provider endpoint on an ASP.NET application. You can specify this using the WSDL Location property on the Web service provider endpoint.

    Note

    Make sure that WSDL file specified is a valid description of the Web service and that it references the Web service provider endpoint at its actual address. If the WSDL file specifies a different address for the provider endpoint, an external Web service is created, and any consumer endpoints connected to the Web service provider endpoint are reconnected to the external Web service.

  • Override the default WSDL binding definition in the automatically generated WSDL file by specifying a WSDL binding location. For more information, see How to: Override WSDL Binding Definitions in WSDL Files.

  • Change the location of the WSDL file that you want to use for a Web service provider endpoint on an implemented ASP.NET Web service.

When you perform these any of these actions, the Add Web Reference dialog box appears.

Note

While the Add Web Reference dialog box appears in each scenario, a Web reference is created only when adding a Web reference to an application project in Solution Explorer. If the Web reference you add to a project is associated with an existing Web service in the solution, the application to which you added the Web reference will be connected to the existing Web service. Otherwise, a new external Web service is created and connected to the application. For more information, see Add Web Reference Dialog Box and How to: Add and Remove Web References.

In all other scenarios, the dialog box makes it possible for you to specify the location of a WSDL file.

Note

WSDL files that contain multiple WSDL bindings or DISCO files that reference multiple Web services are not supported. Do not create external Web services directly from Web services that already exist in your solution. The location of a Web service provider endpoint can be referenced only once on the application diagram. Instead, specify a WSDL file location for a Web service not in the solution.

To specify a WSDL file location for a Web service

  1. In the Add Web Reference dialog box, enter the location of the WSDL file or Web service definition and click Go.

    Tip

    You can specify a WSDL (.wsdl) file, a location on the Web, or the location of a Web service if the Web service publishes its WSDL file automatically.

    If a WSDL file exists, the Add Web Reference dialog box displays information about the Web service and operations it offers.

  2. Click Add Reference.

    The external Web service, BizTalk Web service, or Web service provider endpoint appears on the diagram and is selected.

Depending on the scenario, note the following results and possible actions you might need to take:

See Also

Tasks

Walkthrough: Defining Applications

Other Resources

Defining Applications on Application Diagrams