ASP.NET SQL Server 註冊工具 (Aspnet_regsql.exe)

.NET Framework 工具

ASP.NET SQL Server 註冊工具 (Aspnet_regsql.exe)

 

ASP.NET SQL Server 註冊工具用於建立供 ASP.NET 中的 SQL Server 提供者使用的 Microsoft SQL Server 資料庫，或者用於在現有資料庫中添加或移除選項。Aspnet_regsql.exe 檔位於 Web 服務器上的 [drive:]\WINDOWS\Microsoft.NET\Framework\versionNumber 檔案夾中。

可以不帶任何命令列參數運行 Aspnet_regsql.exe，以運行一個引導您完成如下過程的嚮導：為 SQL Server 安裝指定串連資訊，並為成員資格、角色管理器、設定檔、Web 組件個人化及狀況監控等功能安裝或移除資料庫元素。（該嚮導不涉及設定工作階段狀態和 SQL 緩衝依賴項。）使用下表所列的選項，還可以將 Aspnet_regsql.exe 作為命令列工具來運行，以便為各個功能指定要添加或移除的資料庫元素。

文法 複製代碼

Aspnet_regsql.exe <options>

SQL 串連選項

選項	說明
-?	在命令視窗中顯示 Aspnet_regsql.exe 協助文本。
-W	在嚮導模式下運行該工具。如果未指定任何命令列參數，那麼這是預設設定。
-C <connection string>	指定要串連到正在運行 SQL Server 並且將安裝或者已經安裝資料庫的電腦的連接字串。如果您僅指定伺服器 (-S) 和登入（-U 和 -P 或 -E）資訊，則此選項不是必需的。
-S <server>	指定正在運行 SQL Server 並且將安裝或者已安裝資料庫的電腦的名稱。
-U <login ID>	要用來登入的 SQL Server 使用者識別碼。此選項還要求使用密碼 (-P) 選項。如果要使用 Windows 憑據 (-E) 進行身分識別驗證，則此選項不是必需的。
-P <password>	要用來登入的 SQL Server 密碼。此選項還要求使用使用者識別碼 (-U) 選項。如果要使用 Windows 憑據 (-E) 進行身分識別驗證，則此選項不是必需的。
-E	使用當前登入使用者的 Windows 憑據進行身分識別驗證。
-sqlexportlonly <filename>	產生可用於添加或移除指定功能的 SQL 指令檔。不執行指定的操作。

應用程式服務選項

選項	說明
-A all|m|r|p|c|w	添加對一項或多項 ASP.NET 應用程式服務的支援。可以同時或單獨指定服務識別符。下列標識符用於 ASP.NET 應用程式服務。 all -- 所有的服務，包括由服務共用的通用表和預存程序。 m -- 成員資格 r -- 角色管理器 p -- 設定檔 c -- Web 組件個人化 w -- Web 事件
-R all|m|r|p|c|w	移除對一項或多項應用程式服務的支援。可以同時或單獨指定服務識別符。下列標識符用於 ASP.NET 應用程式服務。 all -- 所有的服務，包括由服務共用的通用表和預存程序。 m -- 成員資格 r -- 角色管理器 p -- 設定檔 c -- Web 組件個人化 w -- Web 事件
-Q	在安靜模式下運行該工具，並且在移除應用程式服務之前不進行確認。
-d <database>	指定要建立或修改以便與應用程式服務一起使用的資料庫的名稱。如果未指定資料庫，則使用預設資料庫名稱“aspnetdb”。

SQL 緩衝依賴項選項（用於 Microsoft SQL Server 7.0、Microsoft SQL Server 2000 和 SQL Server 2005）

選項	說明
-d <database>	指定要與 SQL 緩衝依賴項一起使用的資料庫的名稱。還可以選擇使用連接字串選項 -C 指定該資料庫。
-ed	為 SQL 緩衝依賴項啟用資料庫。
-dd	為 SQL 緩衝依賴項禁用資料庫。
-et	為 SQL 緩衝依賴項啟用表。在參數字串中還必須包括 -t 選項。
-dt	為 SQL 緩衝依賴項禁用表。在參數字串中必須包括 -t 選項。
-t <table>	指定要啟用或禁用以便與 SQL 緩衝依賴項一起使用的表名。此選項必須與 -et 或 -dt 選項一起使用。
-lt	列出所有為 SQL 緩衝依賴項啟用的表。

工作階段狀態選項

選項	說明
-d <database>	指定要儲存工作階段狀態的資料庫的名稱。如果將 -sstype 設定為“c”，則必須使用此選項。
-ssadd	添加對 SQL Server 模式工作階段狀態的支援。
-ssremove	移除對 SQL Server 模式工作階段狀態的支援。
-sstype t|p|c	指定要使用的工作階段狀態的類型： t -- 臨時。工作階段狀態資料存放區在 SQL Server 的 tempdb 資料庫中。用於管理工作階段狀態的預存程序安裝在 SQL Server 的 ASPState 資料庫中。如果重啟 SQL，資料不會保持。這是預設設定。 p -- 持久。工作階段狀態資料和預存程序均儲存在 SQL Server 的 ASPState 資料庫中。 c -- 自訂。工作階段狀態資料和預存程序均儲存在自訂資料庫中。必須使用 -d 選項指定資料庫名。

備忘

使用 ASP.NET SQL Server 註冊工具，您可以設定幾種類型的選項。您可以指定 SQL 串連，指定使用 SQL Server 來管理資訊的 ASP.NET 應用程式服務，指示將哪個資料庫或表用於 SQL 緩衝依賴項，以及添加或移除對使用 SQL Server 來預存程序和工作階段狀態的支援。

幾項 ASP.NET 應用程式服務依賴於提供者來管理資料來源中資料的儲存和檢索。每個提供者都特定於資料來源。ASP.NET 包括一個用於下列 ASP.NET 功能的 SQL Server 提供者：

• 成員資格（SqlMembershipProvider 類）。

• 角色管理（SqlRoleProvider 類）。

• 設定檔（SqlProfileProvider 類）。

• Web 組件個人化（SqlPersonalizationProvider 類）。

• Web 事件（SqlWebEventProvider 類）。

安裝 ASP.NET 時，伺服器的 Machine.config 檔案包括一些配置元素，這些元素為依賴於提供者的每個 ASP.NET 功能指定 SQL Server 提供者。預設情況下，這些提供者被配置為串連到 SQL Server Express 2005 的本機使用者執行個體。如果更改提供者使用的預設連接字串，則必須先使用 Aspnet_regsql.exe 安裝 SQL Server 資料庫和用於所選功能的資料庫元素，然後才能使用在電腦配置中配置的任何 ASP.NET 功能。如果使用 SQL 註冊工具指定的資料庫還不存在（如果未在命令列指定一個資料庫，aspnetdb 將是預設資料庫），則目前使用者必須具有在 SQL Server 中建立資料庫的許可權，以及在資料庫中建立架構元素的許可權。

每個 SQL Server 提供者都可以使用相同的 SQL Server 資料庫來儲存用於該特定功能的資料。每個功能都可以單獨使用，也可以與其他功能結合使用。例如，可以單獨使用角色管理，也可以將它與成員資格所管理的使用者資訊結合使用。

有關 SQL Server 提供者和 ASP.NET 的更多資訊，請參見實現成員資格提供者、實現設定檔提供者和實現角色提供者。

SQL 緩衝依賴項

ASP.NET 輸出緩衝的一項進階功能是 SQL 緩衝依賴項。SQL 緩衝依賴項支援兩種不同模式的操作：第一種模式使用表輪詢的 ASP.NET 實現，第二種模式使用 SQL Server 2005 的查詢通知功能。SQL 註冊工具可用於配置表輪詢模式的操作。SQL 緩衝依賴項使您可以緩衝依賴於 SQL Server 表中資料的頁。您可以配置 SQL Server 和 ASP.NET 以快取頁面請求，降低伺服器工作負載，直到頁所依賴的資料已在 SQL Server 中更新為止。對於相對保持靜態產品目錄或客戶端註冊資訊等資料而言，SQL 緩衝依賴項很有用。注意，當使用 SQL 緩衝依賴項的 ASP.NET 表輪詢模式時，您必須配置 SQL Server 以向 ASP.NET 提供關於依賴資料中的更改的適當通知，因此您需要具有設定管理員的管理特權。有關 SQL 緩衝依賴項的更多資訊，請參見演練：將 ASP.NET 輸出緩衝與 SQL Server 結合使用和演練：使用輸出緩衝增強網站效能。

工作階段狀態

ASP.NET 工作階段狀態是為了使您能在不同的源中方便地儲存 ASP.NET 應用程式的使用者會話資料而設計的。預設情況下，工作階段狀態值和資訊都儲存在 ASP.NET 進程的記憶體中。另外，可以將會話資料存放區在 SQL Server 資料庫中，這種情況下會話資料可由多個 Web 服務器共用。有關工作階段狀態的更多資訊，請參見實現工作階段狀態儲存提供者和工作階段狀態模式。

如果使用 SQL 註冊工具為工作階段狀態指定的資料庫還不存在，則目前使用者必須具有在 SQL Server 中建立資料庫的許可權，以及在資料庫中建立架構元素的許可權。如果資料庫不存在，則目前使用者必須具有在現有資料庫中建立架構元素的許可權。

若要在 SQL Server 上安裝工作階段狀態資料庫，請運行 Aspnet_regsql.exe 工具，並為命令提供下面的資訊：

• 使用 -S 選項指定 SQL Server 執行個體的名稱。

• 有權在運行 SQL Server 的電腦上建立資料庫的帳戶的登入憑據。使用 -E 選項，以使用當前登入的使用者，或者使用 -U 選項指定使用者識別碼，並使用 -P 選項指定密碼。

• 用於添加工作階段狀態資料庫的 -ssadd 命令列選項。

預設情況下，不能使用 Aspnet_regsql.exe 工具在運行 SQL Server 2005 Express Edition 的電腦上安裝工作階段狀態資料庫。有關使用 SQL Server 2005 Express Edition 儲存工作階段狀態的更多資訊，請參見工作階段狀態模式。

樣本

可以在不使用任何命令列參數的情況下運行 Aspnet_regsql.exe，以運行一個引導您完成如下過程的嚮導：為 SQL Server 資料庫指定串連資訊，並為受支援的功能安裝或移除資料庫元素。還可以將 Aspnet_regsql.exe 作為命令列工具來運行，以便為各個功能指定要添加或移除的資料庫元素。要指定 SQL 緩衝依賴項的設定或對工作階段狀態進行設定，必須使用命令列工具。

若要運行嚮導，請不帶任何命令列參數運行 Aspnet_regsql.exe，如下面的樣本所示。

複製代碼

C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.exe

ASP.NET SQL 註冊工具通常使用 -A 或 -R 選項來指定哪些功能使用 SQL Server 提供者。-A 選項允許添加對一項或多項功能的支援，而 -R 選項允許移除一項功能。下面的命令使用 Windows 身分識別驗證，在運行 SQL Server 的本機電腦上安裝成員資格和角色管理器的資料庫元素。

複製代碼

aspnet_regsql.exe -E -S localhost -A mr

若要設定 SQL 緩衝依賴項，您需要具有管理特權，或管理帳戶和密碼。下面的命令為 Northwind 資料庫中的 Employees 表啟用 SQL 緩衝依賴項。

複製代碼

aspnet_regsql.exe -S <Server> -U <Username> -P <Password> -ed -d Northwind -et -t Employees

下面的命令將在名為“SampleSqlServer”的 SQL Server 執行個體上建立一個名為 ASPState 的資料庫，並指定會話資料也儲存在 ASPState 資料庫中。

複製代碼

aspnet_regsql.exe -S SampleSqlServer -E -ssadd -sstype p