步骤 1：使用 WCF LOB 适配器开发向导创建 Echo 适配器项目

完成时间： 15 分钟

在此步骤中，你将使用 Visual Studio 和适配器开发向导创建项目。 适配器开发向导将指导你完成为系统开发自定义适配器所涉及的步骤。 它收集有关消息交换模式、元数据功能、适配器属性和连接属性的信息。 向导成功完成后，会生成一组文件。

必备条件

必须具备 在开始教程之前 所述的知识，并且已使用 WCF LOB 适配器 SDK 成功为适配器开发设置计算机。

在 Visual Studio 中选择 WCF LOB 适配器插件

1. 启动 Visual Studio，然后在“ 文件 ”菜单上，指向“ 新建”，然后单击“ 项目”。

2. 在“新建项目” 对话框中执行以下操作：

   使用此选项	要执行此操作
   项目类型	单击 “Visual C#”。
   模板	单击“ WCF LOB 适配器”。
   名称	键入 EchoAdapter。
   位置	键入 C：\Tutorials。
   为解决方案创建目录	选中此复选框以便为解决方案文件创建目录。
   解决方案名称	键入 EchoAdapterSampleV2。

   下图显示了“ 新建项目 ”对话框。

   

3. 单击 “确定” 。

4. 在“欢迎”页面上，单击“下一步”。 下图显示了 “欢迎” 页。

   

5. 单击“下一步”。

输入方案和命名空间信息

1. 在 “方案、命名空间和 URI 信息 ”页上，执行以下操作：

   使用此选项	要执行此操作
   方案	键入 echov2。
   项目命名空间	键入 Microsoft.Adapters.Samples.EchoV2。

   下图显示了 “方案、命名空间和 URI 信息 ”页。

   

2. 单击“下一步”。

输入数据流和元数据功能

1. 在 “数据流 和 元数据功能 ”页上，执行以下操作：

   消息交换模式

   使用此选项	要执行此操作
   同步出站	选择此复选框。
   同步入站	选择此复选框。

   元数据功能

   使用此选项	要执行此操作
   检索	选择此复选框。
   “浏览”	选择此复选框。
   搜索	选择此复选框。

   注意

   此上下文中的数据流与消息交换模式（概念主题中使用的术语）相同。

   下图显示了 “数据流 和 元数据功能 ”页。

   

2. 单击“下一步”。

输入适配器属性

1. 在“ 适配器属性” 页上，执行以下操作：

2. 添加名为 Count 的属性。 此数字由回显适配器的每个操作使用。 每个操作都将返回 计数次数的 输入值。

   使用此选项	要执行此操作
   属性名称	类型 计数。
   数据类型	选择 “System.Int32”。
   默认值	键入 5。
   添加	单击以添加新的适配器属性。

3. 添加名为 EnableConnectionPooling 的属性。 WCF LOB 适配器 SDK 使用此标志来启用或禁用运行时连接池。

   使用此选项	要执行此操作
   属性名称	键入 EnableConnectionPooling。
   数据类型	选择 “System.Boolean”。
   默认值	键入 true。
   添加	单击以添加新的适配器属性。

4. 添加名为 InboundFileFilter 的属性。 FileSystemWatcher 使用此属性监视此扩展的文件。 此属性仅适用于入站方案。

   使用此选项	要执行此操作
   属性名称	键入 InboundFileFilter。
   数据类型	选择“ System.String”。
   默认值	键入 *.txt。
   添加	单击以添加新的适配器属性。

5. 添加名为 InboundFileSystemWatcherFolder 的属性。 此属性用于设置文件将被删除的文件夹，以便 FileSystemWatcher 向适配器发出通知。 此属性仅适用于入站方案。

   使用此选项	要执行此操作
   属性名称	键入 InboundFileSystemWatcherFolder。
   数据类型	选择“ System.String”。
   默认值	键入 C：\\inbound\\watcher。
   添加	单击以添加新的适配器属性。

   下图显示了“ 适配器属性” 页。

   

6. 单击“下一步”。

输入连接属性

1. 在 “连接属性” 页上，执行以下操作：

2. 添加名为 Application 的属性。 此属性仅用于说明目的。 回显适配器不涉及任何 LOB 系统。

   使用此选项	要执行此操作
   属性名称	键入 “应用程序”。
   数据类型	选择“ System.String”。
   默认值	键入 lobapplication。
   添加	单击以添加新的适配器属性。

3. 添加名为 EnableAuthentication 的属性。 当为 时 true，适配器需要客户端凭据中“用户名”字段中的值。

   使用此选项	要执行此操作
   属性名称	键入 EnableAuthentication。
   数据类型	选择 “System.Boolean”。
   默认值	键入 false。
   添加	单击以添加新的适配器属性。

4. 添加名为 HostName 的属性。 此属性仅用于说明目的，类似于属性 Application。

   使用此选项	要执行此操作
   属性名称	键入 Hostname。
   数据类型	选择“ System.String”。
   默认值	键入 lobhostname。
   添加	单击以添加新的适配器属性。

5. 添加名为 EchoInUpperCase 的属性。 此属性控制某些操作是将回显字符串转换为大写还是保留其原始格式。

   使用此选项	要执行此操作
   属性名称	键入 EchoInUpperCase。
   数据类型	选择 “System.Boolean”。
   默认值	键入 False。
   添加	单击以添加新的适配器属性。

6. 单击“下一步”。

结束向导

1. 在“概要”页上，单击“完成”。 下图显示了使用 EchoAdapter 项目的解决方案资源管理器。

   

   项目应包含相同的文件。 如果没有，请退出 Visual Studio，删除 EchoAdapterSampleV2 文件夹，然后重启本教程的此步骤。

2. 在 Visual Studio 的“ 文件 ”菜单上，单击“ 全部保存”。

   注意

   保存所做的工作。 此时可以安全地关闭 Visual Studio，也可以转到下一步 步骤 2：对适配器和连接属性进行分类。

我只是做什么？

在此步骤中，你使用 Visual Studio 和适配器开发向导创建了回显适配器解决方案。 下表包含文件集以及每个文件的用途。

文件名	说明
EchoAdapter.cs	这是继承自 Microsoft.ServiceModel.Channels.Common.Adapter的main适配器类。 回显适配器无需更改。
EchoAdapterBinding.cs	这是为适配器创建绑定时使用的类。 回显适配器无需更改。
EchoAdapterBindingCollectionElement.cs	这是实现 System.ServiceModel.Configuration.StandardBindingCollectionElement的 Binding 集合元素类。 回显适配器无需更改。
EchoAdapterBindingElement.cs	这为配置元素提供基类。 若要对回显适配器的适配器和连接属性进行分类，请按照 步骤 2：对适配器和连接属性进行分类。
EchoAdapterBindingElementExtensionElement.cs	提供此类用于将适配器表示为绑定元素，以便在用户定义的 WCF 自定义绑定中使用它。 若要对回显适配器的适配器和连接属性进行分类，请按照 步骤 2：对适配器和连接属性进行分类。
EchoAdapterHandlerBase.cs	这是用于存储基类公开的公共属性/帮助程序函数的处理程序的基类。 若要对回显适配器的适配器和连接属性进行分类，请按照 步骤 2：对适配器和连接属性进行分类。
EchoAdapterConnection.cs	这定义了与目标系统的连接。 若要支持回显适配器与目标系统的连接，请按照 步骤 3：实现 Echo 适配器的连接。
EchoAdapterConnectionFactory.cs	这将定义目标系统的连接工厂。 若要支持回显适配器与目标系统的连接，请按照 步骤 3：实现 Echo 适配器的连接。
EchoAdapterConnectionUri.cs	这是用于表示适配器连接 URI 的类。 若要支持回显适配器与目标系统的连接，请按照 步骤 3：实现回显适配器 的连接) 。
EchoAdapterMetadataBrowseHandler.cs	从目标系统对元数据执行基于连接的浏览时使用此类。 若要支持回显适配器的元数据浏览功能，请按照 步骤 4：实现回显适配器的元数据浏览处理程序进行操作。
EchoAdapterMetadataSearchHandler.cs	此类用于对目标系统中的元数据执行基于连接的搜索。 若要支持回显适配器的元数据搜索功能，请遵循 步骤 5：实现回显适配器的元数据搜索处理程序。
EchoAdapterMetadataResolve.cs	此类用于从目标系统执行基于连接的元数据检索。 若要支持回显适配器的元数据解析功能，请按照 步骤 6：实现回显适配器的元数据解析处理程序进行操作。
EchoAdapterOutboundHandler.cs	此类用于将数据发送到目标系统。 若要支持回显适配器的出站消息交换，请遵循 步骤 7：实现回显适配器的同步出站处理程序。
EchoAdapterInboundHandler.cs	此类实现用于侦听或轮询数据的接口。 若要支持回显适配器的入站消息交换，请遵循 步骤 8：实现回显适配器的同步入站处理程序。
EchoAdapterTrace.cs	此类实现适配器跟踪，用于调试和故障排除。

后续步骤

你可以对其 UI 逻辑分组的适配器和连接属性进行分类，然后实现连接、元数据浏览、搜索和解析功能，以及出站和入站消息交换。 最后，生成并部署回显适配器。

另请参阅

步骤 2：对适配器和连接属性分类
教程 1：开发 Echo 适配器