Building And Consuming A Simple XML Web Service - Part 1

Task 2: Add a Windows Forms client project

1. In Solution Explorer, right-click solution ‘CurrencyService’, point to Add, and then click Existing Project.
   
   
2. In the Add Existing Project dialog box:
   
   
   • If you are working with Visual Basic, browse to the E:\Labfiles\Starter\VB\CurrencyClient folder, and then double-click the CurrencyClient project file.
     
   • If you are working with Visual C#, browse to the E:\Labfiles\Starter\CS\CurrencyClient folder, and then double-click the CurrencyClient project file.
     
     
3. In Solution Explorer, right-click the CurrencyClient project, and then click Set as StartUp Project.
   
   
4. In Solution Explorer, right-click the CurrencyClient project, and then click Add Web Reference.
   
   
5. In the Add Web Reference dialog box, on the Start Browsing for Web Services page, click the Web services in this solution link.
   
   
6. On the Web Services in this Solution page, click the Service link.
   
   
7. In the Web reference name text box, overwrite localhost with Currency and then click Add Reference.
   
   
8. In Solution Explorer, in the CurrencyClient project, double-click the DemoForm form, and then familiarize yourself with its contents.
   
   
9. On the View menu, click Code.
   
   
10. Locate the AddTwoNumbers_Click method, and replace the comment in this method with the following code:
    
    
    • If you are working with Visual Basic:
      
      1. Using svc As New Currency.Service()
      2. svc.UseDefaultCredentials = True
      3. c = svc.IntegerSum(a, b)
      4. End Using
         
         
    • If you are working with Visual C#:
      
      
      1. using (Currency.Service svc = new Currency.Service())
      2. {
      3. svc.UseDefaultCredentials = true;
      4. c = svc.IntegerSum(a, b);
      5. }
         
         
      Setting the UseDefaultCredentials property to true will ensure that the requests made by this proxy will be authenticated using the credentials of the currently logged-on user.
      
      
11. Press F5 to run the project. Type two numbers into the First Number and Second Number text boxes, and then verify that you can use the Add button to add two integers and display the results.
    
    There may be a small delay as the Web service is loaded and compiled for the first time, but subsequent calls will be quite fast.
    
    
12. Close the application.
    
    
13. Locate the GetCurrency_Click event handler and replace the comment in this method with the following code:
    
    
    • If you are working with Visual Basic:
      
      1. Using svc As New Currency.Service()
      3. svc.UseDefaultCredentials = True
      4. currencyName = svc.CurrencyForCountry(countryCodeText)
      6. If currencyNameIs Nothing Then
      7. MessageBox.Show(_ String.Format(_ "Currency name could not be determined for country"
      8. _ & " code '{0}'", _ countryCode) _)
      9. Else
      11. MessageBox.Show(_ String.Format("The currency for country code '{0}'"
      12. _ & " is '{1}'", _ countryCode, _ currencyName) _)
      13. End If
      15. End Using
    • If you are working with Visual C#:
      
      1. using(Currency.Service svc = new Currency.Service()) {
      2. svc.UseDefaultCredentials = true;
      3. currencyName = svc.CurrencyForCountry(countryCode);
      5. if (currencyName == null) {
      6. MessageBox.Show(
      7. String.Format(
      8. "Currency name could not be determined for country" + " code '{0}'",
      9. countryCode)
      10. );
      11. } else {
      12. MessageBox.Show(
      13. String.Format("The currency for country code '{0}'" + " is '{1}'",
      14. countryCode,
      15. currencyName)
      16. );
      17. }
      18. }
14. Press F5 to run the project. Type US for the Country Code, click Get Currency, and verify that a message box appears containing the text US Dollar.

Task 3: Examine Web service discovery features

1. In Solution Explorer, in the CurrencyService project, right-click the Service.asmx page, and then click View in Browser.
   
   Internet Explorer displays the Web service test page. By default, when the Microsoft ASP.NET development server runs a Web service, it allocates a port number dynamically.
   
   
2. Examine the start page Uniform Resource Locator (URL), and then make a note of the port number.
   
   
3. Click the Address bar, type http://localhost:port/CurrencyService/Service.asmx?DISCO, and then press ENTER. Replace port with the port number determined in the previous step.
   
   Verify that this action generates and displays the discovery document for the Web service.
   
   
4. Click the Address bar, type http://localhost:port/CurrencyService/Service.asmx?WSDL, and then press ENTER. Replace port with the port number as before.
   
   
5. Verify that this action shows the Web Services Description Language (WSDL) entry for the service. The WSDL page is an XML document that describes the various methods and parameters of the service.
   
   
6. Close Internet Explorer.