你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Connection 类

定义

命名空间:

Microsoft.CognitiveServices.Speech

程序集:

Microsoft.CognitiveServices.Speech.csharp.dll

包:

Microsoft.CognitiveServices.Speech v1.34.0

用于管理与指定识别器语音服务的连接的代理类。 在 1.2.0 中添加

public sealed class Connection : IDisposable

type Connection = class
    interface IDisposable

Public NotInheritable Class Connection
Implements IDisposable

继承

Object

Connection

实现

IDisposable

注解

默认情况下，识别器在需要时自主管理与服务的连接。 Connection 类提供了可用于显式打开或关闭连接以及订阅连接状态更改的其他方法。 Connection 的使用是可选的。 它适用于需要根据连接状态微调应用程序行为的情况。 可以选择调用 Open () 来手动启动服务连接，然后开始识别与此连接关联的识别器。 开始识别后，调用 Open () 或 Close () 可能会失败。 这不会影响识别器或正在进行的识别。 连接可能因各种原因而断开，识别器将始终尝试根据需要重新建立连接，以保证正在进行的操作。 在所有这些情况下，Connected/Disconnected 事件将指示连接状态的更改。

方法

Close()	关闭服务的连接。 可以选择调用 Close () 来手动关闭关联识别器的连接。 调用可能会失败，具体取决于识别器的进程状态。 但失败不会影响关联的识别器的状态。
Dispose()	释放关联的资源。
Finalize()	用于管理与指定识别器语音服务的连接的代理类。 在 1.2.0 中添加
FromConversationTranslator(ConversationTranslator)	从会话翻译器获取 Connection 实例。
FromDialogServiceConnector(DialogServiceConnector)	从指定的对话框服务连接器获取 Connection 实例，该连接器用于观察和管理语音服务的连接和断开连接。
FromRecognizer(Recognizer)	从指定的识别器获取 Connection 实例。
FromSpeechSynthesizer(SpeechSynthesizer)	从指定的语音合成器获取 Connection 实例，用于观察和管理与语音服务的连接和断开连接。 在版本 1.17.0 中添加
Open(Boolean)	开始设置与服务的连接。 可以选择调用 Open () 以在与此连接关联的识别器上开始识别之前提前手动设置连接。 开始识别后，调用 Open () 可能会失败，具体取决于识别器的进程状态。 但失败不会影响关联的识别器的状态。 注意：返回时，连接可能尚未就绪。 请订阅 Connected 事件，以在建立连接时收到通知。
SendMessageAsync(String, Byte[], UInt32)	将二进制消息作为异步操作发送到语音服务。 注意：此方法不适用于 SpeechSynthesizer 的连接。 在 1.10.0 中添加
SendMessageAsync(String, String)	将消息作为异步操作发送到语音服务。 注意：此方法不适用于 SpeechSynthesizer 的连接。 在 1.7.0 中添加
SetMessageProperty(String, String, String)	将消息中的参数追加到服务。 注意：此方法不适用于 SpeechSynthesizer 的连接。 在 1.7.0 中添加

事件

Connected	Connected 事件，指示识别器已连接到服务。 若要在订阅 Connected 事件后接收该事件，Connection 对象本身需要处于活动状态。 如果拥有此事件的 Connection 对象已超过其生存期，则不会传递所有订阅的事件。
Disconnected	Disconnected 事件，指示识别器已与服务断开连接。 若要在订阅后接收 Disconnected 事件，Connection 对象本身需要处于活动状态。 如果拥有此事件的 Connection 对象已超过其生存期，则不会传递所有订阅的事件。
MessageReceived	MessageReceived 事件指示服务已向客户端发送网络消息。