matlab.net.http.ProgressMonitor 类
命名空间: matlab.net.http
超类: handle
HTTP 消息交换的进度监视器
描述
可使用 ProgressMonitor
类为 HTTP 请求消息实现进度监视器。进度监视器可以侦听此类的属性更改,以显示或更新您所选择的内容。
要实现进度监视器,请创建此类的子类。然后创建 HTTPOptions
对象,将该子类指定为 ProgressMonitorFcn
属性,并将 UseProgressMonitor
属性设置为 true
。
当您调用 RequestMessage.send
方法时,将启动 HTTP 请求。在存在重定向和身份验证的情况下,此过程可能涉及到两个方向上的多个消息。当所有传输完成后,MATLAB® 将调用 done
方法。
在传输过程中:
当您调用
RequestMessage.send
时,MATLAB 将设置Max
、CancelFcn
和Direction
属性。随着请求消息主体的发送,MATLAB 将重复设置
Value
属性,以指示已传输的字节数。当开始接收
ResponseMessage
后,MATLAB 会将Direction
设置为Response
,并再次重复设置Value
。要随时取消传输,请调用
CancelFcn
函数。此操作相当于在命令行窗口中中断send
函数。
当 Direction
变成 Response
之后,您可以显示图形进度指示条或其他进度指示。对于每个后续 Value
,将指示条更新为当前 Value
。您还可以利用此机制,以编程方式监视进度。
matlab.net.http.ProgressMonitor
类是一个 handle
类。
创建对象
obj = matlab.net.http.ProgressMonitor(Name,Value)
创建一个进度监视器并由一个或多个名称-值对组参数指定其他属性。Name
是属性名称,Value
是对应的值。您可采用任意顺序指定多个名称-值对组参数,例如 Name1,Value1,...,NameN,ValueN
。未指定的属性设置为默认值。
属性
方法
版本历史记录
在 R2016b 中推出