How to: Add, Update, or Remove a Service Reference
A service reference enables a project to access one or more Windows Communication Foundation (WCF) services. Use the Add Service Reference dialog box to search for WCF services in the current solution, locally, on a local area network, or on the Internet.
Adding a Service Reference
To add a reference to an external service
In Solution Explorer, right-click the name of the project that you want to add the service to, and then click Add Service Reference.
The Add Service Reference dialog box appears.
In the Address box, enter the URL for the service, and then click Go to search for the service. If the service implements username/password security, you may be prompted for a username and password.
Note
You should only reference services from a trusted source. Adding references from an untrusted source may compromise security.
Note
You can also select the URL from a drop-down list that stores the last 15 URLs where valid service metadata was found.
A progress bar is displayed while the search is being performed. You can stop the search at any time by clicking Stop.
In the Service list, expand the node for the service that you want to use and select a service contract.
In the Namespace box, enter the namespace that you want to use for the reference.
Click OK to add the reference to the project.
A service client (proxy) is generated, and metadata describing the service is added to the app.config file.
To add a reference to a service in the current solution
In Solution Explorer, right-click the name of the project that you want to add the service to, and then click Add Service Reference.
The Add Service Reference dialog box appears.
Click Discover.
All WCF services in the current solution are added to the Service list.
In the Service list, expand the node for the service that you want to use and select a service contract.
In the Namespace box, enter the namespace that you want to use for the reference.
Click OK to add the reference to the project.
A service client (proxy) is generated, and metadata describing the service is added to the app.config file.
Updating a Service Reference
Over time, the metadata for a WCF service may change, requiring that the service reference be updated.
To update a service reference
In Solution Explorer, right-click the service reference and then click Update Service Reference.
A progress dialog box is displayed while the reference is updated from its original location, and the service client is regenerated to reflect any changes in the metadata.
Removing a Service Reference
If a service reference is no longer being used, you can remove it from your solution.
To remove a service reference
In Solution Explorer, right-click the service reference and then click Delete.
The service client will be removed from the solution, and the metadata describing the service will be removed from the app.config file.
Note
Any code that references the service reference will have to be removed manually.
See Also
Tasks
How to: Add a Reference to a Web Service
Reference
Add Service Reference Dialog Box
Concepts
Windows Communication Foundation Services and WCF Data Services in Visual Studio