loadrunner Web_类函数之web_create_html_param_ex（）

web_create_html_param_ex（）

从LoadRunner 6.5开始已弃用。使用web_reg_save_param_ex函数。
int web_create_html_param_ex（const char * ParamName，const char * LeftBoundary，
const char * RightBoundary，const char * Instance）;
 参数说明：
object：一个表达式，求值到类型为WebApi的对象。通常是web for Java和Visual Basic。另请参见函数和常量前缀。
ParamName：要创建的新参数的名称。
LeftBoundary：指示参数或动态数据的左边界的字符串。边界参数区分大小写。输入空值（“”）以保存从参数中的页面开始到右边界的所有内容。请参见“边界参数”部分。
RightBoundary：指示参数或动态数据的右边界的字符串。边界参数区分大小写。输入空值（“”）以保存从参数中的左边界到页面结尾的所有内容。请参见“边界参数”部分。
Instance：序列[LeftBoundary][any_string] [RightBoundary]出现的次数，脚本将从中获取参数值。例如，如果Instance设置为3，脚本将搜索左边界的第三次出现，后跟任何字符串，后跟右边界。脚本将参数的左右边界之间的字符串保存。

web_create_html_param_ex函数是一个用于在Web脚本中关联HTML语句的服务函数。 web_create_html_param_ex函数检索重放期间生成的动态信息，然后将动态信息保存到参数中。
注意：此功能对于7.0及更高版本已弃用，但支持向后兼容性。使用web_reg_save_param函数。

运行脚本时，web_create_html_param_ex函数将扫描由脚本访问的后续HTML页面。web_create_html_param_ex函数搜索页面（包括其关联的HTTP响应标头），以查找左边界的出现，后跟任何字符串，后跟右边界[LeftBoundary] [any_string] [RightBoundary]。web_create_html_param_ex函数搜索，直到它找到序列[LeftBoundary] [any_string] [RightBoundary]的第“N”次出现。Instance参数指定值“N”。当脚本发现第N次出现时，脚本将检索左右边界之间的字符串，并将该字符串保存到ParamName指定的参数。
在找到序列的“第N”个出现之后，web_create_html_param_ex函数终止其搜索。

web_create_html_param_ex函数与web_create_html_param函数的不同之处在于，web_create_html_param_ex函数具有一个额外参数Instance。

要在只有一次出现动态数据的页面中关联语句，请使用web_create_html_param。
您可以使用web_set_max_html_param_len函数设置要保存的数据的最大大小。如果某个实例的数据超过最大字符数（默认为256），则不会对该实例进行计数。
由于web_create_html_param_ex函数仅在其后的Web步骤上生效，因此请确保在生成包含动态数据的HTML代码的步骤之前插入语句。
每个web_create_html_param_ex语句仅检索动态数据一次。这意味着如果要在脚本中重新捕获另一个运行时值，则必须插入第二个web_create_html_param_ex语句以检索参数的新值。

web_create_html_param_ex函数首先在HTTP响应标头中搜索所需的字符串，然后在相关的HTML页面内搜索。
所有Web脚本以及以HTTP或无线会话协议（WSP）重放模式运行的WAP脚本支持此功能。

考虑以下HTML代码段，它在Web页面上重复多次。数字00n根据用户点击的位置而改变。第一次出现时为001，第二次为002，依此类推。

首次访问：<ahref=/exec/obidos/subst/help/first–time–visitors.html/00n–8481703–4784428>Buybooks for a penny </a>.</b>

 
当用户点击链接“Buy books for a penny”时，浏览器在/exec/obidos/subst/help/first-time-visitors.html/00n-8481703-4784428显示HTML页面。编号00n-8481703-4784428是每次用户访问站点时更改的参考号，并且仅对该会话有效。要将此动态数字的第六次出现保存到参数，您可以使用web_create_html_param_ex函数。字符串“first-time-visitors.html/”是左边界，“>Buy books for a penny”是右边界。左边界和右边界（00n-8481703-4784428）之间的字符串保存到“user_access_number”参数。检索此动态数字后，您可以在脚本中的任何位置使用它。
web_create_html_param_ex（“user_access_number”，
    “first-time-visitors.html /”，“> Buy books for a penny”，“6”）;