Membership.GetUser Method (String)


Gets the information from the data source for the specified membership user.

Namespace:   System.Web.Security
Assembly:  System.Web (in System.Web.dll)

public static MembershipUser GetUser(
	string username


Type: System.String

The name of the user to retrieve.

Return Value

Type: System.Web.Security.MembershipUser

A MembershipUser object representing the specified user. If the username parameter does not correspond to an existing user, this method returns null.

Exception Condition

username contains a comma (,).


username is null.

The GetUser method retrieves the user information from the data source and creates a MembershipUser object populated with the returned data. If you use one of the GetUser overloads that does not take a username parameter, GetUser returns the information for the current logged-on membership user. The current logged-on membership user is identified by the Name of the user in the current HttpContext.

You can also specify whether you want GetUser to update the last-activity date/time stamp for the user being retrieved with the userIsOnline parameter. Of the GetUser overloads that do not take a userIsOnline parameter, Membership.GetUser implicitly updates the last-activity date/time stamp for the user. Membership.GetUser and GetUser do not.

The following code example uses the GetUser method to return a MembershipUser object for the current logged-on user and updates the e-mail address for the user.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server">

MembershipUser u;

public void Page_Load(object sender, EventArgs args)
  u = Membership.GetUser(User.Identity.Name);

  if (!IsPostBack)
    EmailTextBox.Text = u.Email; 

public void UpdateEmailButton_OnClick(object sender, EventArgs args)
    u.Email = EmailTextBox.Text;


    Msg.Text = "User e-mail updated.";
  catch (System.Configuration.Provider.ProviderException e)
    Msg.Text = e.Message;

<html xmlns="" >
<title>Sample: Update User E-Mail</title>

<form id="form1" runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  <table cellpadding="3" border="0">
      <td>E-mail Address:</td>
      <td><asp:TextBox id="EmailTextBox" MaxLength="128" Columns="30" runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
                                    ControlToValidate="EmailTextBox" ForeColor="red"
                                    Display="Static" ErrorMessage="Required" /></td>
      <td><asp:Button id="UpdateEmailButton" 
                      Text="Update E-mail" 
                      runat="server" /></td>


.NET Framework
Available since 2.0
Return to top