How to: Locate WSDL Files for Web Services
In Application Designer, you must specify the location of a Web Services Description Language (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 .NET Web Service provider endpoint from a WSDL file. For more information, see How to: Add Endpoints to Applications, How to: Add Endpoints to Application Systems, and How to: Add Endpoints to Members of Application Systems.
Conform an existing Web service endpoint to a WSDL file. For more information, see How to: Conform Web Service Endpoints to WSDL Files.
Specify a different WSDL file for generating Web references to an implemented .NET 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
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.
Click Add Reference.
The external Web service, BizTalk Web service, or .NET Web Service provider endpoint appears and is selected.
Depending on the scenario, note the following results and possible actions you might need to take:
If you added an external or BizTalk Web service, a System Definition Model (.sdm) file appears immediately in the Solution Items folder in Solution Explorer. For more information, see Overview of the System Definition Model (SDM).
If you created a .NET Web Service provider endpoint on an ASP.NET application from a WSDL file, an .asmx file and Web service class file appear in the application project if the application is implemented. For more information, see Overview of ASP.NET Applications on Application Diagrams.
If you specified a different WSDL file for an existing Web service provider endpoint, you might want to update any Web references to that Web service. For more information, see How to: Refresh Web References to Web Services on Application Diagrams.
See Also
Tasks
Walkthrough: Defining Applications on Application Diagrams