Membership.GetUser Method (String)
Gets the information from the data source for the specified membership user.
Assembly: System.Web (in System.Web.dll)
Parameters
- username
-
Type:
System.String
The name of the user to retrieve.
Return Value
Type: System.Web.Security.MembershipUserA MembershipUser object representing the specified user. If the username parameter does not correspond to an existing user, this method returns null.
| Exception | Condition |
|---|---|
| ArgumentException | username contains a comma (,). |
| ArgumentNullException | 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="vb" %> <%@ Import Namespace="System.Web.Security" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> Dim u As MembershipUser Public Sub Page_Load(sender As Object, args As EventArgs) u = Membership.GetUser(User.Identity.Name) If Not IsPostBack Then EmailTextBox.Text = u.Email End Sub Public Sub UpdateEmailButton_OnClick(sender As Object, args As EventArgs) Try u.Email = EmailTextBox.Text Membership.UpdateUser(u) Msg.Text = "User e-mail updated." Catch e As System.Configuration.Provider.ProviderException Msg.Text = e.Message End Try End Sub </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>Sample: Update User E-Mail</title> </head> <body> <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"> <tr> <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> </tr> <tr> <td></td> <td><asp:Button id="UpdateEmailButton" Text="Update E-mail" OnClick="UpdateEmailButton_OnClick" runat="server" /></td> </tr> </table> </form> </body> </html>
Available since 2.0