ProfileBase.SetPropertyValue(String, Object) Metoda

Reference

Definice

Obor názvů:: System.Web.Profile

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nastaví hodnotu vlastnosti profilu.

public:
 void SetPropertyValue(System::String ^ propertyName, System::Object ^ propertyValue);

public void SetPropertyValue (string propertyName, object propertyValue);

member this.SetPropertyValue : string * obj -> unit

Public Sub SetPropertyValue (propertyName As String, propertyValue As Object)

Parametry

propertyName: String

Název vlastnosti, kterou chcete nastavit.

propertyValue: Object

Hodnota, kterou chcete přiřadit vlastnosti.

Výjimky

ProviderException

Došlo k pokusu o nastavení hodnoty vlastnosti v anonymním profilu, kde je falseatribut vlastnosti allowAnonymous .

SettingsPropertyNotFoundException

Pro aktuální profil nejsou definovány žádné vlastnosti.

-nebo-

Zadaný název vlastnosti profilu v aktuálním profilu neexistuje.

-nebo-

Zprostředkovatel zadané vlastnosti profilu nerozpoznal zadanou vlastnost.

SettingsPropertyIsReadOnlyException

Došlo k pokusu o nastavení hodnoty vlastnosti, která byla označena jako jen pro čtení.

SettingsPropertyWrongTypeException

Došlo k pokusu o přiřazení hodnoty vlastnosti pomocí nekompatibilního typu.

Příklady

Následující příklad kódu ukazuje ASP.NET stránku, která přečte a nastaví vlastnost zadanou ZipCode pro profil uživatele. Příklad souboru Web.config, který určuje vlastnosti profilu uživatele, najdete v příkladu zadaném ProfileBase pro třídu.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

<%@ 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>

Poznámky

ASP.NET použije ProfileBase třídu k vytvoření třídy použité pro profil uživatele. Při spuštění aplikace s povoleným profilem uživatele ASP.NET vytvoří novou třídu typu ProfileCommon, která dědí z ProfileBase třídy. Přístupové objekty silného ProfileCommon typu jsou přidány do třídy pro každou vlastnost definovanou v části konfigurace profilu . Objekty ProfileCommon se silnými typy třídy volají metodu SetPropertyValue pro předání hodnot vlastností do objektu ProfileProvider , který má být uložen ve zdroji dat.

Pomocí metody můžete SetPropertyValue přiřadit hodnoty vlastností v profilu uživatele pro vaši aplikaci podle názvu. Hodnoty jsou netypové a kontrola typu se provádí za běhu, nikoli v době kompilace. Pro přístup k hodnotám vlastností profilu se silnými typy můžete k vlastnosti přistupovat podle názvu jako člen Profile vlastnosti, která je k dispozici na každé stránce, Profile.CustomerAddressnapříklad .

Platí pro

Viz také

přehled vlastností profilu ASP.NET

Sdílet prostřednictvím