ProfileBase 建構函式

定義

命名空間:: System.Web.Profile

組件:: System.Web.dll

重要

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

建立 ProfileBase 類別的執行個體。

public:
 ProfileBase();

public ProfileBase();

Public Sub New ()

例外狀況

ProviderException

enabledWeb.config 檔案中設定檔區段的屬性為 false。

ConfigurationErrorsException

無法建立 Web.config 檔案的設定檔區段中指定的屬性類型。

-或-

allowAnonymousWeb.config 檔案的設定檔區塊中屬性設定trueenabled為，匿名識別>元素的屬性<設false為。

-或-

serializeAsWeb.config 檔案的剖析區段中屬性設定為 Binary ，且的屬性為，且 typefalse的屬性為 IsSerializable 。

-或-

使用 provider 設定檔屬性指定的提供者名稱在集合中找不到 Providers 。

-或-

無法找到該剖面屬性的指定條件 type 。

-或-

設定檔屬性會以與設定檔區段屬性中基inherits底類別屬性名稱相符的名稱來指定。

範例

以下的 Web.config 檔案指定一個使用者設定檔，包含一個 ZipCode 屬性 string 為的屬性和 RecentSearchList 屬性為 StringCollection。電流產生 Profile 的屬性 HttpContext 會對每個指定屬性有強型別的存取器。

<configuration>
   <connectionStrings>
       <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
   </connectionStrings>

  <system.web>
   <anonymousIdentification enabled="true" />

   <profile defaultProvider="SqlProvider" >
     <providers>
       <add
         name="SqlProvider"
         connectionStringName="SqlServices"
         applicationName="ProfileBaseApplication"
         type="System.Web.Profile.SqlProfileProvider" />
     </providers>

     <properties>
       <add name="ZipCode" allowAnonymous="true" />
       <add name="RecentSearchList"
            type="System.Collections.Specialized.StringCollection"
            serializeAs="Xml"
            allowAnonymous="true" />
      </properties>
    </profile>
   </system.web>
</configuration>

以下 ASP.NET 頁面會讀取並設定 ZipCode 使用者設定檔所指定的屬性。

這很重要

此範例包含一個接受使用者輸入的文字框，這可能構成安全威脅。預設情況下，ASP.NET 網頁會驗證使用者輸入中不包含腳本或 HTML 元素。欲了解更多資訊，請參閱腳本漏洞概述。

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

public void Page_PreRender()
{
  if (Profile.ZipCode == null)
  {
    PersonalizePanel.Visible = false;
    GetZipCodePanel.Visible = true;
  }
  else
  {
    ZipCodeLabel.Text = Profile.ZipCode;

    // Get personalized information for zip code here.

    PersonalizePanel.Visible = true;
    GetZipCodePanel.Visible = false;
  }
}

public void ChangeZipCode_OnClick(object sender, EventArgs args)
{
  ZipCodeTextBox.Text = Profile.ZipCode;
  Profile.ZipCode = null;

  PersonalizePanel.Visible = false;
  GetZipCodePanel.Visible = true;
}

public void EnterZipCode_OnClick(object sender, EventArgs args)
{
  Profile.ZipCode = ZipCodeTextBox.Text;
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>

<form id="form1" runat="server">
  <table border="1" cellpadding="2" cellspacing="2">
    <tr>
      <td>
        <asp:Panel id="PersonalizePanel" runat="Server" Visible="False">
          Information for Zip Code: <asp:Label id="ZipCodeLabel" Runat="Server" /><br />
          <!-- Information for Zip Code here. -->
          <br />
          <asp:LinkButton id="ChangeZipCodeButton" Runat="Server" Text="Change Your Zip Code"
                          OnClick="ChangeZipCode_OnClick" />
        </asp:Panel>
        <asp:Panel id="GetZipCodePanel" runat="Server" Visible="False">
          You can personalize this page by entering your Zip Code: 
          <asp:TextBox id="ZipCodeTextBox" Columns="5" MaxLength="5" runat="Server" />
          <asp:LinkButton id="EnterZipCodeButton" Runat="Server" Text="Go"
                          OnClick="EnterZipCode_OnClick" />
        </asp:Panel>
      </td>
    </tr>
  </table>
</form>

</body>
</html>

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Public Sub Page_PreRender()

  If Profile.ZipCode = Nothing Then
    PersonalizePanel.Visible = False
    GetZipCodePanel.Visible = True
  Else
    ZipCodeLabel.Text = Profile.ZipCode

    ' Get personalized information for zip code here.

    PersonalizePanel.Visible = True
    GetZipCodePanel.Visible = False
  End If

End Sub

Public Sub ChangeZipCode_OnClick(sender As Object, args As EventArgs)
  ZipCodeTextBox.Text = Profile.ZipCode
  Profile.ZipCode = Nothing

  PersonalizePanel.Visible = False
  GetZipCodePanel.Visible = True
End Sub

Public Sub EnterZipCode_OnClick(sender As Object, args As EventArgs)
  Profile.ZipCode = ZipCodeTextBox.Text
End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>

<form id="form1" runat="server">
  <table border="1" cellpadding="2" cellspacing="2">
    <tr>
      <td>
        <asp:Panel id="PersonalizePanel" runat="Server" Visible="False">
          Information for Zip Code: <asp:Label id="ZipCodeLabel" Runat="Server" /><br />
          <!-- Information for Zip Code here. -->
          <br />
          <asp:LinkButton id="ChangeZipCodeButton" Runat="Server" Text="Change Your Zip Code"
                          OnClick="ChangeZipCode_OnClick" />
        </asp:Panel>
        <asp:Panel id="GetZipCodePanel" runat="Server" Visible="False">
          You can personalize this page by entering your Zip Code: 
          <asp:TextBox id="ZipCodeTextBox" Columns="5" MaxLength="5" runat="Server" />
          <asp:LinkButton id="EnterZipCodeButton" Runat="Server" Text="Go"
                          OnClick="EnterZipCode_OnClick" />
        </asp:Panel>
      </td>
    </tr>
  </table>
</form>

</body>
</html>

備註

ASP.NET 會用這個 ProfileBase 類別來建立用於使用者設定檔的類別。當啟用使用者設定檔的應用程式啟動時，ASP.NET 會建立一個新的類型 ProfileCommon類別，該類別繼承自該 ProfileBase 類別。在設定檔設定區段中定義的每個屬性，都會為類別加入ProfileCommon強型別的存取器。該類別的ProfileCommon強型別存取器呼叫GetPropertyValue基底類別的 ProfileBase 和 SetPropertyValue 方法，分別取得 profile 屬性值並設定。類別的 ProfileCommon 一個實例被設定為該屬性的值 Profile ，用於 ASP.NET 應用。

備註

用來產生儲存在屬性中的Profile類別的基底類別，可以透過設定檔中 profile 區段的屬性來覆寫inherits。在這種情況下，你會指定一個自訂類別，繼承自基 ProfileBase 底類別。

此建構器並非設計用來從應用程式程式碼中使用。要建立使用者個人檔案的實例，請使用此 Create 方法。

適用於

另請參閱

ASP.NET 物業概覽

意見反應

此頁面對您有幫助嗎？

共用方式為

ProfileBase 建構函式

定義

例外狀況

範例

備註

適用於

另請參閱

意見反應