URLFetchAsynchronous

在版本 11 中，URLFetchAsynchronous 已经被 URLSubmit 取代.

URLFetchAsynchronous["url",func]

在后台中执行链接，当发起事件时，调用 func.

更多信息和选项

可能发起的事件类型：

	"data"	返回字节列表，并且表明连接已经完成
	"progress"	返回关于形如 {dlnow,dltotal,ulnow,ultotal} 的当前链接的信息
	"error"	表明当尝试连接到 URL 时出现错误
	"headers"	从网络服务器接收到的头部
	"cookies"	所有已知 cookies 的列表
	"statuscode"	服务器所返回的状态代码

可以给出下列选项：

Method	"GET"	用于请求的方法
"Parameters"	{}	发送给请求的参数
"Body"	""	发送的消息体内容
"MultipartElements"	{}	发送的多部分数据元素的列表
"Username"	""	用于请求的用户名
"Password"	""	用于请求的密码
"Headers"	{}	手动发送给 HTTP 服务器的头部
"Cookies"	Automatic	是否存储接收到的 cookie
"StoreCookies"	True	传递给服务器的cookie
"VerifyPeer"	True	使用 SSL 证明验证身份
"UserAgent"	Automatic	发送的用户代理字符串
"ReadTimeout"	0	允许用于上传或者下载数据的时间
"ConnectTimeout"	0	允许连接服务器的时间
"Progress"	False	是否发起 "progress" 事件
"Transfer"	Automatic	如果 Automatic，"data" 事件返回一次，并且返回所有下载的数据；如果 "Chunks"，将从上一次事件开始多次发起具有下载数据的 "data"事件
"UserData"	None	传递给该选项的任意表达式将存储用于在事件函数内使用的AsynchronousTaskObject；数据可以通过检查传递给事件函数的选项 AsynchronousTaskObject 找到
"FollowRedirects"	True	是否重定向

默认情况下，允许的时间以秒为单位给出.
多部分元素的格式为 {"name","mimetype"}->val，其中 val 是一个字符串或者字节列表.
当发起一个事件时，将执行传递给 URLFetchAsynchronous 的事件函数 . 将有三个参数被传递给事件函数，分别是：AsynchronousTaskObject、事件名称和从事件获取到的数据. 事件函数是处理从 URLFetchAsynchronous 获取的数据的唯一方法.

范例

打开所有单元关闭所有单元

基本范例 (3)

这里打开一个对话框，当下载完成时：

存储头部和 cookies：

使用状态代码和错误事件来判断 URL 的可用性：

选项 (16)

"Method" (1)

"Method" 可用以指定链接所使用的 HTTP 方法：

"Parameters" (1)

指定应该发送到服务器的参数：

"VerifyPeer" (1)

验证服务器所使用的 SSL 证书是有效的：

"Username" (1)

指定应该发送到服务器的用户名：

"Password" (1)

指定应该发送到服务器的密码：

"UserAgent" (1)

指定应该发送给服务器的用户代理：

"Cookies" (1)

手动控制 URLFetchAsynchronous 所使用的 cookie：

"StoreCookies" (1)

如果 False，当链接到全局 cookie share 中的站点时，"StoreCookies" 不会放置找到的任何 cookie：

"Headers" (1)

指定发送到服务器的头部：

"BodyData" (1)

指定当链接到服务器应该发送的消息体：

"MultipartData" (1)

指定多部分消息体的内容：

"ReadTimeout" (1)

指定完成从服务器下载数据所分配的最大时间（以秒为单位）：

"ConnectTimeout" (1)

以秒为单位指定建立到服务器的链接所分配的最大时间：

"Progress" (1)

如果 True，将发起 "progress" 事件，返回下载和上传的进度信息：

"Transfer" (1)

如果 "Transfer" 设为 "Chunks"，当服务器可以访问数据时，将立即返回数据，而不用等到整个链接完成：

"UserData" (1)

当调用事件时，"UserData" 是包含可用信息的任意表达式：

属性和关系 (1)

使用 URLSaveAsynchronous 把输出存储在文件中：

顶部