playbook/docs/tsl/codegen/dotnet/runtime/network_http.md

运行时 / 网络与HTTP

appendHttpHeader(session, header)

向指定会话中添加请求头信息

参数	类型	说明
session	any	Session ID
header	string	要添加的请求头信息

返回：any

clearHttpHeader(session)

清除会话中的请求头信息

参数	类型	说明
session	any	可选参数，整数类型，session ID，缺省时指当前会话。

返回：any

destroyHttpSession(session, return_value)

销毁一个Http Session对象，并返回销毁结果，销毁成功返回True。 仅新一代TSL语言支持该函数。

参数	类型	说明
session	int	可选参数，整数类型，Session ID，缺省时指当前会话。
return_value	bool	object

返回：bool

getHttp(session, url, time_out, value, code)

网络访问以及相关函数相关函数。

参数	类型	说明
session	int	int
url	string	int
time_out	int
value	string
code	int

返回：bool

getHttpContent(session, frompos, return_value)

获得HTTP返回的具体内容，可以从frompos开始取，缺省是取全部。 这个可以方便在progress回调函数中实现文件的临时存贮，亦可以动态打印内容。 仅新一代TSL语言支持该函数。

参数	类型	说明
session	intptr	指定session ID
frompos	int	可选参数，指定开始位置，位置从1开始，缺省时指取全部
return_value	int	获取到的具体内容

返回：string

getHttpCookies(session)

获取指定会话、来自服务器设置的Cookies信息

参数	类型	说明
session	any	Session ID

返回：any

getHttpResponseHeader(session, return_value)

获得HTTP返回的头信息，可以在header回调中看全部合成的header，也可以从已经完成会话的时候获得会话的头部信息。

参数	类型	说明
session	int	可选参数，指定session ID。缺省时指当前会话。仅新一代TSL语言支持该可选参数。
return_value	string	当前下载到的完整的头部信息

返回：string

internetRequest(session, url, refer, header, post_data, user_name, pass_word, result_type, response_code, time_out)

发送Internet访问请求，主要用于Web建立网站。

参数	类型	说明
session	int	可选参数，整数类型，session ID，缺省时指当前会话。多次访问且需要使用同一条链路时，可指定为同个session ID。；注：旧版本TSL语言中，该参数含义为连接模式：0-微软WININET模式；1-TCP模式。
url	string	字符串类型，需要获取的URL串。如:http://www.tinysoft.com.cn
refer	int	引用者。
header	string	发送请求的Http请求头。
post_data	int	发送的数据。
user_name	int	用户名。
pass_word	string	密码。
result_type	string	非0则Result返回Binary类型，为0则Result返回字符串类型。
response_code	string	存放返回的HTTP代码。例如，当正确的时候返回为200。
time_out	string	获取URL等待的毫秒数。

返回：bool

postHttp(session, url, content, time_out, value, code)

以POST方式从指定的HTTP URL获得内容。

参数	类型	说明
session	int	可选参数，整数类型，session ID，缺省时指当前会话。多次访问且需要使用同一条链路时，可指定为同个session ID。；注：旧版本TSL语言中，该参数含义为连接模式：0-微软WININET模式；1-TCP模式。
url	string	字符串类型，需要获取的URL串。如:http://www.tinysoft.com.cn
content	string	二进制或字符串类型；要发送的数据。
time_out	int	获取URL等待的毫秒数。
value	string	存放返回的内容。
code	int	存放返回的HTTP代码。例如，当正确的时候返回为200。

返回：bool

setHttpAuth(session, user_name, pass_word, _type)

设置指定会话中认证信息

参数	类型	说明
session	any	Session ID
user_name	string	用户名
pass_word	string	密码
_type	any	可选参数，认证信息类型；可多次调用以设置不同类型的认证信息：

返回：any

setHttpCallBack(session, callback, t, return_value)

设置http回调，缺省回调模式是progress模式，可以通过t设定为"header"设置头部回调函数。仅新一代TSL语言支持该函数。

参数	类型	说明
session	int	session ID
callback	TFUNCTION	函数对象，回调函数。可通过findfunction(functionname)方式获取
t	string	可选参数，设置进度回调或头部模式。
return_value	缺省模式，Progress模式指在HTTP请求|响应传输过程中，实时追踪数据传输进度的回调机制	无

返回：回调函数的返回值为0表示继续，非0则结束请求

setHttpCookies(session, cookies)

设置指定会话中Cookies信息

参数	类型	说明
session	any	Session ID
cookies	string	要设置的Cookies值信息，多个Cookie以分号分隔，如SESSIONID=ABC123;THEME=DARK；一般无需设置，同一会话中发送的多次请求会自动携带服务器设置的Cookies

返回：any

setHttpMode(session, mode, return_value)

设置chunked模式（分段模式），主要用于大模型类的一个请求分段输出模式，支持类似于大模型一样按单词吐词输出。仅新一代TSL语言支持该函数。

参数	类型	说明
session	any	指定session ID
mode	any	输出模式，取值如下：
return_value	any	无

返回：any

setHttpProxy(session, proxy_addr, proxy_type)

设置指定会话中代理信息

参数	类型	说明
session	any	Session ID
proxy_addr	string	代理地址
proxy_type	any	可选参数，代理类型：

返回：any

setHttpVerifySsl(session, verify)

设置指定会话是否校验服务器证书

参数	类型	说明
session	any	Session ID
verify	bool	object

返回：any

URL 内容函数

urlToText(a_src)

将URL标准格式的串转化为文本字符串

参数	类型	说明
a_src	string	字符串类型

返回：string

示例

a_src := "%23abcd%20%2010";
return urlToText(a_src);
// 结果：#abcd 10