PersonalizationAdministration.FindUserState 方法

參考

定義

命名空間:: System.Web.UI.WebControls.WebParts

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

根據指定的參數傳回每一使用者個人化狀態資訊的集合。

多載

FindUserState(String, String)	根據使用者名稱和網頁路徑傳回每一使用者個人化狀態資訊的集合。
FindUserState(String, String, Int32, Int32, Int32)	根據指定的參數傳回每一使用者個人化狀態資訊的集合。

FindUserState(String, String)

根據使用者名稱和網頁路徑傳回每一使用者個人化狀態資訊的集合。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);

static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollection

參數

pathToMatch: String

符合的網頁路徑。

usernameToMatch: String

符合的使用者名稱，其中包括與網頁相關聯的個人化資料。

傳回

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection，包含每一使用者個人化狀態資訊。

例外狀況

ArgumentException

pathToMatch 或 usernameToMatch 於修剪前後為空字串 ("")。

-或-

組態中定義的個人化提供者之提供者不是正確的型別。

-或-

任一參數的字串長度大於 256 個字元。

ConfigurationErrorsException

在嘗試建立及初始化其中一個設定的個人化提供者的執行個體時，發生組態例外狀況。

-或-

找不到組態中定義的預設個人化提供者。

範例

下列程式碼範例會示範如何使用 FindUserState 方法。您可以在類別概觀主題中找到 PersonalizationAdministration 完整的範例。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

備註

這個方法會傳回實例集合 UserPersonalizationStateInfo ， pathToMatch 其中參數值符合頁面的路徑，並 usernameToMatch 符合具有與該頁面相關聯個人化數據的用戶名稱。集合只 UserPersonalizationStateInfo 包含實例。

此方法會將參數通配符傳遞至基礎個人化提供者，因此數據存放區如何處理這些字元，取決於提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 。

一般而言，針對符合 SQL 規範的數據存放區，您可以在部分路徑上執行通配符搜尋，其中通配符會出現在屬性的 PathToMatch 開頭、結尾或搜尋字串文字中間。例如，若要尋找以 “~/vdir” 開頭的所有路徑， PathToMatch 屬性會設定為 “~/vdir%”。

同樣地，部分用戶名稱上的通配符搜尋可能會讓通配符出現在屬性的文字字串 UsernameToMatch 中的任何一點。例如，若要尋找開頭為「John」的所有使用者名稱， UsernameToMatch 屬性看起來會像「John%」。

使用預設個人化提供者時， PersonalizationStateInfo衍生物件會依字母順序傳回，並以路徑和使用者名稱的組合來依遞增順序排序。集合中物件的排序是由提供者決定。

pathToMatch與 usernameToMatch 可以是 null。參數 usernameToMatch 可以有逗號 (，) ，因為某些數據存放區，例如執行 Microsoft SQL Server 的數據存放區，允許逗號做為通配符。

另請參閱

適用於

FindUserState(String, String, Int32, Int32, Int32)

根據指定的參數傳回每一使用者個人化狀態資訊的集合。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

參數

pathToMatch: String

符合的網頁路徑。

usernameToMatch: String

符合的使用者名稱，其中包括與網頁相關聯的個人化資料。

pageIndex: Int32

要傳回的結果網頁之以零起始的索引。

pageSize: Int32

要傳回的資料錄數。

totalRecords: Int32

可用的資料錄總數。

傳回

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection，包含每一使用者個人化狀態資訊。

例外狀況

ArgumentException

pathToMatch 或 usernameToMatch 於修剪前後為空字串 ("")。

-或-

pageIndex 小於零。

-或-

pageSize 小於或等於零。

-或-

和 pageSize 的組合pageIndex超過 Int32.MaxValue。

-或-

組態中定義的個人化提供者之提供者不是正確的型別。

-或-

任一參數的字串長度大於 256 個字元。

ConfigurationErrorsException

在嘗試建立及初始化其中一個設定的個人化提供者的執行個體時，發生組態例外狀況。

-或-

找不到組態中定義的預設個人化提供者。

範例

下列程式碼範例會示範如何使用 FindUserState 方法。您可以在類別概觀主題中找到 PersonalizationAdministration 完整的範例。

重要

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

備註

此方法會將參數通配符傳遞至基礎個人化提供者，因此數據存放區如何處理這些字元，取決於提供者如何處理字元作為星號 (*) 、百分比符號 (%) 或底線 (_) 。

使用預設個人化提供者時， PersonalizationStateInfo衍生物件會依字母順序傳回，並以路徑和使用者名稱的組合來依遞增順序排序。集合中對象的順序是由提供者決定。

傳回的數據受限於 pageIndex 和，其中 pageIndex 會控制要傳回哪些記錄，以及pageSize控制要傳回pageSize的記錄數目。例如，如果 pageIndex 設定為 0 且 pageSize 設定為 25，則傳回的數據會是前 25 個專案。如果 pageIndex 設定為 1 且 pageSize 設定為 25，則傳回的數據會是專案 26 到 50。參數 totalRecords 會傳回可用的記錄總數。

另請參閱

適用於

共用方式為

PersonalizationAdministration.FindUserState 方法

定義

多載

FindUserState(String, String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

FindUserState(String, String, Int32, Int32, Int32)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源