Transact-SQL 參考

創建一項生成 HTML 文檔的任務，該文檔包含執行過的查詢返回的數據。

說明所有 Web 作業在企業管理器的"作業分類"對話框中都被歸為 Web 助手。有關更多信息，請參見定義作業。

sp_makewebtask [@outputfile =] 'outputfile', [@query =] 'query'[, [@fixedfont =]fixedfont][, [@bold =]bold][, [@italic =]italic][, [@colheaders =]colheaders][, [@lastupdated =]lastupdated][, [@HTMLheader =]HTMLheader][, [@username =]username][, [@dbname =]dbname][, [@templatefile =] 'templatefile'][, [@webpagetitle =] 'webpagetitle'][, [@resultstitle =] 'resultstitle'][[, [@URL =] 'URL', [@reftext =] 'reftext']| [, [@table_urls =]table_urls, [@url_query =] 'url_query']][, [@whentype =]whentype][, [@targetdate =]targetdate][, [@targettime =]targettime][, [@dayflags =]dayflags][, [@numunits =]numunits][, [@unittype =]unittype][, [@PRocname =]procname ][, [@maketask =]maketask][, [@rowcnt =]rowcnt][, [@tabborder =]tabborder][, [@singlerow =]singlerow][, [@blobfmt =]blobfmt][, [@nrowsperpage =] n][, [@datachg =] table_column_list][, [@charset =] characterset][, [@codepage =] codepage]

[@outputfile =] 'outputfile'

在 Microsoft® SQL Server™ 的實例上生成的 HTML 文件的位置。如果文檔將在遠程計算機上生成，則該參數可以是 UNC 名稱。outputfile 的數據類型為 nvarchar(255)，沒有默認值。

[@query =] 'query'

要運行的查詢。query 的數據類型為 ntext，沒有默認值。當通過 sp_runwebtask 運行任務時，查詢結果將以表格形式顯示在 HTML 文檔中?？梢灾付ǘ鄠€ SELECT 查詢，從而導致在 outputfile 中顯示多個表。

[@fixedfont =]fixedfont

指定查詢結果是以固定字體 (1) 還是以成比例字體 (0) 顯示。fixedfont 的數據類型為 tinyint，默認值為 1。

[@bold =]bold

指定查詢結果是以粗體 (1) 還是非粗體 (0) 顯示。bold 的數據類型為 tinyint，默認值為 0。

[@italic =]italic

指定查詢結果是以斜體 (1) 還是非斜體 (0) 顯示。italic 的數據類型為 tinyint，默認值為 0。

[@colheaders =]colheaders

指定查詢結果是帶列標題 (1) 還是不帶列標題 (0) 顯示。colheaders 的數據類型為 tinyint，默認值為 1。

[@lastupdated =]lastupdated

指定所生成的 HTML 文檔是否顯示"上次更新時間："時間戳指示上次更新的日期和時間 (1) 或者沒有時間戳 (0)。在 HTML 文檔中，時間戳出現在查詢結果的前一行。lastupdated 的數據類型為 tinyint，默認值為 1。

[@HTMLHeader =]HTMLHeader

指定用于顯示包含在 resultstitle 中的文本的 HTML 格式代碼。HTMLheader 的數據類型為 tinyint，可以是下列值之一。

[@username =]username

是執行查詢的用戶名。username 的數據類型為 nvarchar (128)，默認設置為當前用戶。系統管理員或數據庫所有者可以指定其它用戶名。

[@dbname =]dbname

在其上運行查詢的數據庫名。dbname 的數據類型為 nvarchar(128)，默認值為當前數據庫。

[@templatefile =] 'templatefile'

用于生成 HTML 文檔的模板文件的路徑。模板文件包含 HTML 文檔的格式特征信息和標記 <%insert_data_here%>，該標記指示將查詢結果添加到 HTML 表中的位置。templatefile 的數據類型為 nvarchar(255)。

指定查詢結果在模板文件中位置的方法有兩種：

1. 通過包含 <%insert_data_here%> 標記指定一個通用表格式，該標記指示將查詢結果添加到 HTML 表中的位置。標記間沒有間隔。當使用 <%insert_data_here%> 時，fixedfont、bold、italic、colheaders 和 tabborders 值都將應用于查詢結果。
2. 指定完整的行格式，以便生成更加精確的版面。使用 <%begindetail%>和 <%enddetail%> 標記，并在這兩個標記之間使用 <TR>、</TR>、<TD> 和 </TD> 這些 HTML 標記定義完整的行格式。對于每個要顯示在結果集中的列，都插入 <%insert_data_here%> 標記。當使用完整行格式時，下列 sp_makewebtask 參數將被忽略：

   Bold	lastupdated	table_urls
   Colheaders	reftext	URL
   Fixedfont	resultstitle	url_query
   HTMLheader	singlerow	webpagetitle
   Italic	tabborder

   被 sp_makewebtask 所調用的擴展過程可以讀取 Unicode 和非 Unicode 模板文件。如果 Unicode 文件包含簽名標題，則該標題將在生成 HTML 文件時刪除。

[@webpagetitle =] 'webpagetitle'

HTML 文檔的標題。webpagetitle 的數據類型為 nvarchar(255)，默認值為 SQL Server Web Assistant。對于空白標題，需要為標題指定兩個空格字符，或通過編輯 HTML 源文件來刪除 <TITLE> 和 </TITLE> 標記以及標記中間的標題文本。

[@resultstitle =] 'resultstitle'

HTML 文檔中顯示查詢結果上方的標題。resultstitle 的數據類型為 nvarchar(255)，默認值為 Query Results。

[@URL =] 'URL'

轉到其它 HTML 文檔的超級鏈接。該超級鏈接位于查詢結果之后、HTML 文檔末尾。URL 的數據類型為 nvarchar(255)。如果指定了 URL，也必須指定 reftext，但不能指定 table_ur