ProfileBase.SetPropertyValue(String, Object) Método

Referência

Definição

Namespace:: System.Web.Profile

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define o valor de uma propriedade de perfil.

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)

Parâmetros

propertyName: String

O nome da propriedade a ser definida.

propertyValue: Object

O valor a ser atribuído à propriedade.

Exceções

ProviderException

Foi feita uma tentativa de definir um valor da propriedade em um perfil anônimo em que o atributo allowAnonymous da propriedade é false.

SettingsPropertyNotFoundException

Não existem propriedades definidas para o perfil atual.

- ou -

O nome da propriedade de perfil especificado não existe no perfil atual.

- ou -

O provedor para a propriedade do perfil especificado não reconheceu a propriedade especificada.

SettingsPropertyIsReadOnlyException

Foi feita uma tentativa de definir um valor em uma propriedade marcada como somente leitura.

SettingsPropertyWrongTypeException

Foi feita uma tentativa de atribuir um valor a uma propriedade usando um tipo incompatível.

Exemplos

O exemplo de código a seguir mostra uma página ASP.NET que lê e define a ZipCode propriedade especificada para o perfil de usuário. Para obter um exemplo de um arquivo Web.config que especifica propriedades para o perfil de usuário, consulte o exemplo fornecido para a ProfileBase classe.

Importante

Este exemplo contém uma caixa de texto que aceita a entrada do usuário, que é uma ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

ASP.NET usa a ProfileBase classe para criar a classe usada para o perfil do usuário. Quando um aplicativo que tem o perfil de usuário habilitado é iniciado, ASP.NET cria uma nova classe de tipoProfileCommon, que herda da ProfileBase classe. Acessadores fortemente tipados são adicionados à ProfileCommon classe para cada propriedade definida na seção de configuração de perfil . Os acessadores fortemente tipado da ProfileCommon classe chamam o SetPropertyValue método para passar valores de propriedade para os ProfileProvider que serão armazenados na fonte de dados.

Você pode usar o SetPropertyValue método para atribuir valores de propriedade no perfil de usuário para seu aplicativo pelo nome. Os valores não são tipados e a verificação de tipo será feita em tempo de execução, não em tempo de compilação. Para acesso fortemente tipado a valores de propriedade de perfil, você pode acessar a propriedade pelo nome como um membro da Profile propriedade que está disponível em cada página, por exemplo, Profile.CustomerAddress.

Aplica-se a

Confira também

Visão geral das propriedades do perfil ASP.NET

Compartilhar via