步骤 1:使用适配器服务开发向导创建 Web 项目
完成时间: 10 分钟
在此步骤中,将使用 Visual Studio 和适配器服务开发向导创建项目。 适配器服务开发向导收集有关适配器、操作和终结点配置的信息,并生成一个 Web 项目,然后可以部署到 IIS。
必备条件
在开始本教程之前,必须生成并部署 教程 1:开发 Echo 适配器中所述的 Echo 示例。
启动适配器服务开发向导
启动 Visual Studio,然后在“ 文件 ”菜单上,指向“ 新建”,然后单击“ 网站”。
在“ 新建网站 ”对话框中,执行以下操作:
使用此选项 要执行此操作 语言 单击 “Visual C#”。 模板 单击“ WCF 适配器服务”。 位置 选择“ 文件系统”,然后键入 C:\Tutorials\EchoWeb 作为路径。 单击 “确定” 。
在 “欢迎”页上,单击“ 下一步”。
选择适配器和 URI
在“选择用于生成服务协定的操作”页上,从“选择绑定”下拉列表中选择 echoAdapterBindingV2,然后单击“配置”。
在“配置适配器”对话框的“安全性”选项卡上,将“客户端凭据类型”设置为“用户名”,然后设置“用户名凭据”,如下所示:
属性 值 用户名 username 密码 password 注意
此处输入的用户名和密码仅用于在执行向导中的步骤时连接到适配器,在向导完成后不会保留。
单击“ URI 属性 ”选项卡,然后按如下所示设置属性:
属性 值 应用程序 LobApplication EnableAuthentication True 主机名 lobhostname EchoInUpperCase False 注意
此处选择的 URI 属性将用于在 web.config 文件中创建 <客户端><终结点> 元素。
单击“ 绑定属性” 选项卡。记下默认值,然后单击“ 确定”。
注意
绑定值将用于在 web.config 文件中生成 <绑定><echoAdapterBindingV2> 元素。
选择协定和操作
在 “选择生成服务协定的操作 ”页上,单击“ 连接”。
在 “选择类别 树”中,选择“ 主类别”。 这会填充 “可用类别和操作 ”列表。
注意
还可以在 “在类别中搜索 ”字段中输入搜索词,以查找包含搜索词的任何操作。
在 “可用类别和操作 ”列表中,选择“ EchoGreetings ”,然后单击“ 添加”。 这会将 EchoGreetings 操作移动到 “添加的类别和操作 ”列表。 此处选择的操作将通过向导生成的客户端代理代码向客户端应用程序公开。
单击“下一步”。
配置服务和终结点行为
在 “配置服务和终结点行为 ”页上,为 “服务行为配置”输入以下值:
属性 值 EnableMetadataExchange True IncludeExceptionDetailsinFault True 名称 customServiceBehavior UseServiceCertificate False 这些值用于填充 <serviceBehaviors>。
为 终结点行为配置输入以下值:
属性 值 名称 customEndpointBehavior AuthenticationType HTTPUsernamePassword UsernameHeader MyUserHeader PasswordHeader MyPassHeader 这些值将用于在 web.confg 中的 <endpointBehaviors 元素中指定 adapterSecurityBridgeType。
点击“下一步”
配置绑定
在“配置服务终结点绑定和地址”页上,选择“配置协定的地址和绑定”中的 BindingConfiguration 条目,然后单击省略号 (...) 按钮。
在“ 自定义绑定 ”对话框中,将“ 模式 ”设置为 TransportWithMessageCredential,然后单击“ 确定”。
单击“ 应用”,然后单击“ 下一步”。
在 “摘要 ”页上,查看为此项目选择的合同和操作,然后单击“ 完成”。 你将看到 EchoWeb 解决方案,其中包含适配器服务开发向导创建的项目文件
内容回顾
在此步骤中,你使用适配器服务开发向导生成了一个 Web 项目,在发布到 IIS 时,该项目将托管 教程 1:在 IIS 过程中开发回显适配器中开发的回显适配器 。 生成的 Web 项目允许 Web 服务和 WCF 客户端访问所选操作。
后续步骤
若要生成和部署 Web 项目,请继续执行 步骤 2:部署 Web 项目