--- title: Bind to a Web Service Using BindingSource ms.date: "03/30/2017" dev_langs: - "csharp" - "vb" - "cpp" helpviewer_keywords: - "Web services [Windows Forms], binding controls" - "BindingSource component [Windows Forms], binding to a Web service" - "examples [Windows Forms], BindingSource component" - "controls [Windows Forms], binding to Web service" - "BindingSource component [Windows Forms], examples" ms.assetid: ee261207-4573-4cb9-a8cb-5185037e0fba --- # How to: Bind to a Web Service Using the Windows Forms BindingSource If you want to bind a Windows Form control to the results obtained from calling an XML Web service, you can use a component. This procedure is similar to binding a component to a type. You must create a client-side proxy that contains the methods and types exposed by the Web service. You generate a client-side proxy from the Web service (.asmx) itself, or its Web Services Description Language (WSDL) file. Additionally, your client-side proxy must expose the fields of complex types used by the Web service as public properties. You then bind the to one of the types exposed in the Web service proxy. ### To create and bind to a client-side proxy 1. Create a Windows Form in the directory of your choice, with an appropriate namespace. 2. Add a component to the form. 3. Open the Windows Software Development Kit (SDK) command prompt, and navigate to the same directory that your form is located in. 4. Using the WSDL tool, enter `wsdl` and the URL for the .asmx or WSDL file for the Web service, followed by the namespace of your application, and optionally the language you are working in. The following code example uses the Web service located at `http://webservices.eraserver.net/zipcoderesolver/zipcoderesolver.asmx`. For example, for C# type `wsdl http://webservices.eraserver.net.zipcoderesolver/zipcoderesolver.asmx /n:BindToWebService`, or for Visual Basic type `wsdl http://webservices.eraserver.net.zipcoderesolver/zipcoderesolver.asmx /n:BindToWebService /language:VB`. Passing the path as an argument to the WSDL tool will generate a client-side proxy in the same directory and namespace as your application, in the specified language. If you are using Visual Studio, add the file to your project. 5. Select a type in the client-side proxy to bind to. This is typically a type returned by a method offered by the Web service. The fields of the chosen type must be exposed as public properties for binding purposes. [!code-cpp[System.Windows.Forms.DataConnectorWebService#4](~/samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#4)] [!code-csharp[System.Windows.Forms.DataConnectorWebService#4](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#4)] [!code-vb[System.Windows.Forms.DataConnectorWebService#4](~/samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#4)] 6. Set the property of the to the type you want that is contained in the Web service client-side proxy. [!code-cpp[System.Windows.Forms.DataConnectorWebService#2](~/samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#2)] [!code-csharp[System.Windows.Forms.DataConnectorWebService#2](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#2)] [!code-vb[System.Windows.Forms.DataConnectorWebService#2](~/samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#2)] ### To bind controls to the BindingSource that is bound to a Web service - Bind controls to the , passing the public property of the Web service type that you want as a parameter. [!code-cpp[System.Windows.Forms.DataConnectorWebService#3](~/samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#3)] [!code-csharp[System.Windows.Forms.DataConnectorWebService#3](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#3)] [!code-vb[System.Windows.Forms.DataConnectorWebService#3](~/samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#3)] ## Example The following code example demonstrates how to bind a component to a Web service, and then how to bind a text box to the component. When you click the button, a Web service method is called and the results will appear in `textbox1`. [!code-cpp[System.Windows.Forms.DataConnectorWebService#1](~/samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#1)] [!code-csharp[System.Windows.Forms.DataConnectorWebService#1](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#1)] [!code-vb[System.Windows.Forms.DataConnectorWebService#1](~/samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#1)] ## Compiling the Code This is a complete example that includes a `Main` method, and a shortened version of client-side proxy code. This example requires: - References to the System, System.Drawing, System.Web.Services, System.Windows.Forms and System.Xml assemblies. ## See also - [BindingSource Component](bindingsource-component.md) - [How to: Bind a Windows Forms Control to a Type](how-to-bind-a-windows-forms-control-to-a-type.md)