The DCS ProxyBuilder Utility
The ProxyBuilder utility builds an assembly for the DCS service proxy that enables client applications to invoke operations in a DCS service. In addition to creating the proxy assembl, the utility also examines the source assembly and copies any dependent assemblies to the output directory. If a proxy assembly for the service already exists in the target folder, the utility replaces the assembly with a new version.
Note: |
|---|
| The ProxyBuilder utility is located in ProxyBuilder folder in the DCS Business Logic Visual Studio Extensions folder under the folder where you installed DCS. |
The ProxyBuilder utility takes several arguments, which fall into two categories: commands and options. Command arguments are required when you invoke the utility; options enable you to trigger additional functionality in the utility when it runs.
The following table describes the command arguments.
|
Argument |
Description |
|---|---|
|
-assembly= |
The assembly that contains the service implementation to generate a proxy from. This is usually the primary .dll file in the compiled output. |
|
-targetDir= |
The directory in which to place the proxy assembly and any related assemblies. |
The following table describes the option arguments.
|
Argument |
Description |
|---|---|
|
-config= |
The file name of a configuration file to include with the proxy assembly. |
|
-targetNS= |
The namespace to use for the proxy assembly. |
|
-generateNotificationStub |
If notification activities are present in the operation, the utility generates a notification stub inside the proxy class. |
|
-excludeAssemblies= |
Enables you to specify a list of assemblies to exclude. |
The following command line sample generates a proxy object for the service in the folder C:\Repository\ServiceAssemblies.
ProxyBuilder –assembly="C:\ServiceDevelopmentFolder\Bin\Debug\Service.dll –targetDir="C:\Repository\ServiceAssemblies"
The following command line sample generates a proxy object for the service in the folder C:\Repository and includes the App.config file with the proxy object.
ProxyBuilder –assembly="C:\ServiceDevelopmentFolder\Bin\Debug\Service.dll –targetDir="C:\Repository\ServiceAssemblies" –config=" C:\ServiceDevelopmentFolder\Bin\Debug\App.config"
Note: