Create a WCF Service target from scratch, or migrate a WCF Service target from
PowerBuilder Classic to PowerBuilder .NET.
Note: To create a target with minimal properties, click Finish at
any time the button is enabled. You can then use the Project painter to specify
WCF Service target properties.
- Click , or open the New dialog box from the toolbar.
- From the Target category, select WCF Service.
- Specify how to create the target:
- Create a new WCF Service target
- Convert a PowerBuilder Classic .NET Web Service target
- Continue stepping through the New WCF Service pages, following the instructions on each page.
Optional: If you are creating the target from scratch, you can choose whether to generate an initial object—Custom Nonvisual, standard nonvisual objects, or None—on the page Specify an object to create.
- On the Hosting Options page, choose the type of host on which you plan to deploy your
service:
| Hosting Environment |
Common Scenarios |
|---|
| IIS |
Running a WCF service side-by-side with ASP.NET content on the Internet using the HTTP,
HTTPS, TPS, or Named Pipes protocols (if the Web Administration Service
component is installed). |
| Console |
Console applications used during development, supporting transport protocols like HTTP,
HTTPS, TCP, and Named Pipes. |
- If you chose the IIS hosting option, the Specify Virtual Directory Name page lets you specify
the IIS virtual directory name for the WCF service.
The Web service virtual directory name is the most important setting for a .NET Web service.
The default value is the application name of the current target.
The Web
service URL preview automatically displays the URL that will be used to
access the service, based on the virtual directory name you
provide.
- In the Specify Deployment Options page, choose one of:
| Option |
Description |
|---|
| Generate setup file |
If you enter a file name with no path information, the file is created in the directory
where the PowerBuilder target file exists. If you enter a file name with
the path, make sure that the directory exists before deployment
begins. |
| Directly deploy to IIS |
Enter the machine name or IP address of an IIS server machine. |
- If you specified the console hosting option, the New WCF Service page enables you to specify
console information:
| Option |
Description |
|---|
| Application file name |
Enter the console application file name with an
.exe extension. The file is created in the
output directory. Note: The console application file name cannot be the
same as the assembly file name.
|
| Base address |
Enter a base address for deployed WCF services. For example:
http://localhost:8001 |
- Review the Summary page and click Finish to create the
target.
When you use the WCF Service target wizard to create a target, the wizard creates an
application object, a project object that allows you to deploy the assembly, and a
nonvisual object (NVO). However, you must add and implement at least one public method
in the wizard-created NVO before you can use it to create a WCF Service.
Next
After you create a WCF Service target, use the Project painter to:
- Modify the project settings
- Deploy the project
- Run the project
- Debug the project