Membership.GetUser Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene le informazioni di un utente di appartenenza dall'origine dati.
Overload
GetUser(String, Boolean) |
Ottiene dall'origine dati le informazioni dell'utente di appartenenza specificato. Se specificato, aggiorna l'indicatore di ultima data e ora di attività dell'utente. |
GetUser(Object, Boolean) |
Ottiene dall'origine dati le informazioni dell'utente di appartenenza associato all'identificatore univoco specificato. Se specificato, aggiorna l'indicatore di ultima data e ora di attività dell'utente. |
GetUser(String) |
Ottiene dall'origine dati le informazioni dell'utente di appartenenza specificato. |
GetUser(Boolean) |
Ottiene dall'origine dati le informazioni dell'utente di appartenenza correntemente connesso al sistema. Se specificato, aggiorna l'indicatore di ultima data e ora di attività dell'utente di appartenenza correntemente connesso al sistema. |
GetUser() |
Ottiene le informazioni dall'origine dati e aggiorna l'indicatore di ultima data e ora di attività dell'utente di appartenenza correntemente connesso al sistema. |
GetUser(Object) |
Ottiene dall'origine dati le informazioni dell'utente di appartenenza associato all'identificatore univoco specificato. |
GetUser(String, Boolean)
Ottiene dall'origine dati le informazioni dell'utente di appartenenza specificato. Se specificato, aggiorna l'indicatore di ultima data e ora di attività dell'utente.
public:
static System::Web::Security::MembershipUser ^ GetUser(System::String ^ username, bool userIsOnline);
public static System.Web.Security.MembershipUser GetUser (string username, bool userIsOnline);
static member GetUser : string * bool -> System.Web.Security.MembershipUser
Public Shared Function GetUser (username As String, userIsOnline As Boolean) As MembershipUser
Parametri
- username
- String
Nome dell'utente da recuperare.
- userIsOnline
- Boolean
Se true
, aggiorna l'indicatore di ultima data e ora di attività dell'utente specificato.
Restituisce
Oggetto MembershipUser che rappresenta l'utente specificato. Se il parametro username
non corrisponde a un utente esistente, questo metodo restituisce null
.
Eccezioni
username
contiene una virgola (,).
username
è null
.
Esempio
Nell'esempio di codice seguente viene recuperata la password per un nome utente specificato e inviata all'indirizzo di posta elettronica per l'utente specificato. La chiamata a GetUser specifica che l'indicatore di data/ora dell'ultima attività per l'utente non viene aggiornato.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Net.Mail" %>
<!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_Load(object sender, EventArgs args)
{
if (!Membership.EnablePasswordRetrieval)
{
FormsAuthentication.RedirectToLoginPage();
}
Msg.Text = "";
if (!IsPostBack)
{
Msg.Text = "Please enter a user name.";
}
else
{
VerifyUsername();
}
}
public void VerifyUsername()
{
MembershipUser user = Membership.GetUser(UsernameTextBox.Text, false);
if (user == null)
{
Msg.Text = "The user name " + Server.HtmlEncode(UsernameTextBox.Text) + " was not found. Please check the value and re-enter.";
QuestionLabel.Text = "";
QuestionLabel.Enabled = false;
AnswerTextBox.Enabled = false;
EmailPasswordButton.Enabled = false;
}
else
{
QuestionLabel.Text = user.PasswordQuestion;
QuestionLabel.Enabled = true;
AnswerTextBox.Enabled = true;
EmailPasswordButton.Enabled = true;
}
}
public void EmailPassword_OnClick(object sender, EventArgs args)
{
// Note: Returning a password in clear text using email is not recommended for
// sites that require a high level of security.
try
{
string password = Membership.Provider.GetPassword(UsernameTextBox.Text, AnswerTextBox.Text);
MembershipUser u = Membership.GetUser(UsernameTextBox.Text);
EmailPassword(u.Email, password);
Msg.Text = "Your password was sent via email.";
}
catch (MembershipPasswordException e)
{
Msg.Text = "The password answer is incorrect. Please check the value and try again.";
}
catch (System.Configuration.Provider.ProviderException e)
{
Msg.Text = "An error occurred retrieving your password. Please check your values " +
"and try again.";
}
}
private void EmailPassword(string email, string password)
{
try
{
MailMessage Message = new MailMessage("administrator", email);
Message.Subject = "Your Password";
Message.Body = "Your password is: " + Server.HtmlEncode(password);
SmtpClient SmtpMail = new SmtpClient("SMTPSERVER");
SmtpMail.Send(Message);
}
catch
{
Msg.Text = "An exception occurred while sending your password. Please try again.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Retrieve Password</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Retrieve Password</h3>
<asp:Label id="Msg" runat="server" ForeColor="maroon" /><br />
Username: <asp:Textbox id="UsernameTextBox" Columns="30" runat="server" AutoPostBack="true" />
<asp:RequiredFieldValidator id="UsernameRequiredValidator" runat="server"
ControlToValidate="UsernameTextBox" ForeColor="red"
Display="Static" ErrorMessage="Required" /><br />
Password Question: <b><asp:Label id="QuestionLabel" runat="server" /></b><br />
Answer: <asp:TextBox id="AnswerTextBox" Columns="60" runat="server" Enabled="false" />
<asp:RequiredFieldValidator id="AnswerRequiredValidator" runat="server"
ControlToValidate="AnswerTextBox" ForeColor="red"
Display="Static" ErrorMessage="Required" Enabled="false" /><br />
<asp:Button id="EmailPasswordButton" Text="Email My Password"
OnClick="EmailPassword_OnClick" runat="server" Enabled="false" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Net.Mail" %>
<!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_Load(ByVal sender As Object, ByVal args As EventArgs)
If Not Membership.EnablePasswordRetrieval Then
FormsAuthentication.RedirectToLoginPage()
End If
Msg.Text = ""
If Not IsPostBack Then
Msg.Text = "Please enter a user name."
Else
VerifyUsername()
End If
End Sub
Private Sub VerifyUsername()
Dim user As MembershipUser = Membership.GetUser(UsernameTextBox.Text, False)
If user Is Nothing Then
Msg.Text = "The user name " & Server.HtmlEncode(UsernameTextBox.Text) & " was not found. Please check the value and re-enter."
QuestionLabel.Text = ""
QuestionLabel.Enabled = False
AnswerTextBox.Enabled = False
EmailPasswordButton.Enabled = False
Else
QuestionLabel.Text = user.PasswordQuestion
QuestionLabel.Enabled = True
AnswerTextBox.Enabled = True
EmailPasswordButton.Enabled = True
End If
End Sub
Public Sub EmailPassword_OnClick(ByVal sender As Object, ByVal args As EventArgs)
' Note: Returning a password in clear text using email is not recommended for
' sites that require a high level of security.
Try
Dim password As String = Membership.Provider.GetPassword(UsernameTextBox.Text, AnswerTextBox.Text)
Dim u As MembershipUser = Membership.GetUser(UsernameTextBox.Text)
EmailPassword(u.Email, password)
Msg.Text = "Your password was sent via email."
Catch e As MembershipPasswordException
Msg.Text = "The password answer is incorrect. Please check the value and try again."
Catch e As System.Configuration.Provider.ProviderException
Msg.Text = "An error occurred retrieving your password. Please check your values " & _
"and try again."
End Try
End Sub
Private Sub EmailPassword(ByVal email As String, ByVal password As String)
Try
Dim Message As MailMessage = New MailMessage("administrator", email)
Message.Subject = "Your Password"
Message.Body = "Your password is: " & Server.HtmlEncode(password)
Dim SmtpMail As SmtpClient = New SmtpClient("SMTPSERVER")
SmtpMail.Send(Message)
Catch
Msg.Text = "An exception occurred while sending your password. Please try again."
End Try
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Retrieve Password</title>
</head>
<body>
<form id="form1" runat="server">
<h3>
Retrieve Password</h3>
<asp:Label ID="Msg" runat="server" ForeColor="maroon" /><br />
Username:
<asp:TextBox ID="UsernameTextBox" Columns="30" runat="server" AutoPostBack="True" />
<asp:RequiredFieldValidator ID="UsernameRequiredValidator" runat="server" ControlToValidate="UsernameTextBox"
ForeColor="red" Display="Static" ErrorMessage="Required" /><br />
Password Question: <b>
<asp:Label ID="QuestionLabel" runat="server" /></b><br />
Answer:
<asp:TextBox ID="AnswerTextBox" Columns="60" runat="server" Enabled="False" />
<asp:RequiredFieldValidator ID="AnswerRequiredValidator" runat="server" ControlToValidate="AnswerTextBox"
ForeColor="red" Display="Static" ErrorMessage="Required" Enabled="False" /><br />
<asp:Button ID="EmailPasswordButton" Text="Email My Password" OnClick="EmailPassword_OnClick"
runat="server" Enabled="False" />
</form>
</body>
</html>
Commenti
Il GetUser metodo recupera le informazioni utente dall'origine dati e crea un MembershipUser oggetto popolato con i dati restituiti.
Se si utilizza uno degli GetUser overload che non accettano un username
parametro, GetUser restituisce le informazioni per l'utente di appartenenza connesso corrente. L'utente di appartenenza connesso corrente è identificato dall'oggetto Name dell'utente nell'oggetto corrente HttpContext.
È anche possibile specificare se si desidera GetUser aggiornare il timestamp di data/ora dell'ultima attività per l'utente recuperato con il userIsOnline
parametro .
GetUser Degli overload che non accettano un userIsOnline
parametro, Membership.GetUser aggiorna in modo implicito il timestamp di data/ora dell'ultima attività per l'utente.
Membership.GetUser e GetUser non lo fanno.
Vedi anche
Si applica a
GetUser(Object, Boolean)
Ottiene dall'origine dati le informazioni dell'utente di appartenenza associato all'identificatore univoco specificato. Se specificato, aggiorna l'indicatore di ultima data e ora di attività dell'utente.
public:
static System::Web::Security::MembershipUser ^ GetUser(System::Object ^ providerUserKey, bool userIsOnline);
public static System.Web.Security.MembershipUser GetUser (object providerUserKey, bool userIsOnline);
static member GetUser : obj * bool -> System.Web.Security.MembershipUser
Public Shared Function GetUser (providerUserKey As Object, userIsOnline As Boolean) As MembershipUser
Parametri
- providerUserKey
- Object
Identificatore univoco dell'utente, ottenuto dall'origine dati di appartenenze dell'utente.
- userIsOnline
- Boolean
Se true
, aggiorna l'indicatore di ultima data e ora di attività dell'utente specificato.
Restituisce
Oggetto MembershipUser che rappresenta l'utente associato all'identificatore univoco specificato.
Eccezioni
providerUserKey
è null
.
Commenti
Il GetUser metodo recupera le informazioni utente dall'origine dati e crea un MembershipUser oggetto popolato con i dati restituiti. L'utente viene identificato con l'identificatore univoco dell'origine dati specificata nel providerUserKey
parametro .
Vedi anche
Si applica a
GetUser(String)
Ottiene dall'origine dati le informazioni dell'utente di appartenenza specificato.
public:
static System::Web::Security::MembershipUser ^ GetUser(System::String ^ username);
public static System.Web.Security.MembershipUser GetUser (string username);
static member GetUser : string -> System.Web.Security.MembershipUser
Public Shared Function GetUser (username As String) As MembershipUser
Parametri
- username
- String
Nome dell'utente da recuperare.
Restituisce
Oggetto MembershipUser che rappresenta l'utente specificato. Se il parametro username
non corrisponde a un utente esistente, questo metodo restituisce null
.
Eccezioni
username
contiene una virgola (,).
username
è null
.
Esempio
L'esempio di codice seguente usa il GetUser metodo per restituire un MembershipUser oggetto per l'utente connesso corrente e aggiorna l'indirizzo di posta elettronica per l'utente.
<%@ Page Language="C#" %>
<%@ 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">
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)
{
try
{
u.Email = EmailTextBox.Text;
Membership.UpdateUser(u);
Msg.Text = "User email updated.";
}
catch (System.Configuration.Provider.ProviderException e)
{
Msg.Text = e.Message;
}
}
</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>Email 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 Email"
OnClick="UpdateEmailButton_OnClick"
runat="server" /></td>
</tr>
</table>
</form>
</body>
</html>
<%@ 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 email 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>Email 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 Email"
OnClick="UpdateEmailButton_OnClick"
runat="server" /></td>
</tr>
</table>
</form>
</body>
</html>
Commenti
Il GetUser metodo recupera le informazioni utente dall'origine dati e crea un MembershipUser oggetto popolato con i dati restituiti. Se si utilizza uno degli GetUser overload che non accettano un username
parametro, GetUser restituisce le informazioni per l'utente di appartenenza connesso corrente. L'utente di appartenenza connesso corrente è identificato dall'oggetto Name dell'utente nell'oggetto corrente HttpContext.
È anche possibile specificare se si desidera GetUser aggiornare il timestamp di data/ora dell'ultima attività per l'utente recuperato con il userIsOnline
parametro .
GetUser Degli overload che non accettano un userIsOnline
parametro, Membership.GetUser aggiorna in modo implicito il timestamp di data/ora dell'ultima attività per l'utente.
Membership.GetUser e GetUser non lo fanno.
Vedi anche
Si applica a
GetUser(Boolean)
Ottiene dall'origine dati le informazioni dell'utente di appartenenza correntemente connesso al sistema. Se specificato, aggiorna l'indicatore di ultima data e ora di attività dell'utente di appartenenza correntemente connesso al sistema.
public:
static System::Web::Security::MembershipUser ^ GetUser(bool userIsOnline);
public static System.Web.Security.MembershipUser GetUser (bool userIsOnline);
static member GetUser : bool -> System.Web.Security.MembershipUser
Public Shared Function GetUser (userIsOnline As Boolean) As MembershipUser
Parametri
- userIsOnline
- Boolean
Se true
, aggiorna l'indicatore di ultima data e ora di attività dell'utente specificato.
Restituisce
Oggetto MembershipUser che rappresenta l'utente correntemente connesso al sistema.
Eccezioni
Nessun utente di appartenenza è attualmente connesso.
Esempio
Nell'esempio di codice seguente viene visualizzato il nome utente per l'utente di appartenenza connesso corrente nella pagina ASP.NET senza aggiornare l'indicatore di data/ora dell'ultima attività per l'utente.
<%@ Page Language="C#" %>
<%@ 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">
MembershipUser currentUser;
public void Page_Load()
{
currentUser = Membership.GetUser(false);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>
<form id="form1" runat="server">
Welcome <b><%=currentUser.UserName%></b>.
</form>
</body>
</html>
<%@ 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 currentUser As MembershipUser
Public Sub Page_Load()
currentUser = Membership.GetUser(False)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>
<form id="form1" runat="server">
Welcome <b><%=currentUser.UserName%></b>.
</form>
</body>
</html>
Commenti
Il GetUser metodo recupera le informazioni utente dall'origine dati e crea un MembershipUser oggetto popolato con i dati restituiti. Se si utilizza uno degli GetUser overload che non accettano un username
parametro, GetUser restituisce le informazioni per l'utente di appartenenza connesso corrente. L'utente di appartenenza connesso corrente è identificato dall'oggetto Name dell'utente nell'oggetto corrente HttpContext.
È anche possibile specificare se si desidera GetUser aggiornare il timestamp di data/ora dell'ultima attività per l'utente recuperato usando il userIsOnline
parametro .
GetUser Degli overload che non accettano un userIsOnline
parametro, GetUser()
aggiorna in modo implicito il timestamp di data/ora dell'ultima attività per l'utente.
GetUser(System.String)
e GetUser(System.Object)
non lo fanno.
Vedi anche
Si applica a
GetUser()
Ottiene le informazioni dall'origine dati e aggiorna l'indicatore di ultima data e ora di attività dell'utente di appartenenza correntemente connesso al sistema.
public:
static System::Web::Security::MembershipUser ^ GetUser();
public static System.Web.Security.MembershipUser GetUser ();
static member GetUser : unit -> System.Web.Security.MembershipUser
Public Shared Function GetUser () As MembershipUser
Restituisce
Oggetto MembershipUser che rappresenta l'utente correntemente connesso al sistema.
Eccezioni
Nessun utente di appartenenza è attualmente connesso.
Esempio
Nell'esempio di codice seguente viene aggiornato l'indicatore di data/ora dell'ultima attività per l'utente di appartenenza connesso corrente e viene visualizzato il nome utente nella pagina ASP.NET.
<%@ Page Language="C#" %>
<%@ 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">
MembershipUser currentUser;
public void Page_Load()
{
currentUser = Membership.GetUser();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>
<form id="form1" runat="server">
Welcome <b><%=currentUser.UserName%></b>.
</form>
</body>
</html>
<%@ 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 currentUser As MembershipUser
Public Sub Page_Load()
currentUser = Membership.GetUser()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>
<form id="form1" runat="server">
Welcome <b><%=currentUser.UserName%></b>.
</form>
</body>
</html>
Commenti
GetUser() recupera le informazioni utente dall'origine dati e crea un MembershipUser oggetto popolato con i dati restituiti. Se si utilizza uno degli GetUser overload che non accettano un username
parametro, GetUser restituisce le informazioni per l'utente di appartenenza connesso corrente. L'utente di appartenenza connesso corrente è identificato dall'oggetto Name dell'utente nell'oggetto corrente HttpContext.
È anche possibile specificare se si desidera GetUser aggiornare il timestamp di data/ora dell'ultima attività per l'utente recuperato usando il userIsOnline
parametro .
GetUser Degli overload che non accettano un userIsOnline
parametro, GetUser()
aggiorna in modo implicito il timestamp di data/ora dell'ultima attività per l'utente.
GetUser(System.String)
e GetUser(System.Object)
non lo fanno.
Vedi anche
Si applica a
GetUser(Object)
Ottiene dall'origine dati le informazioni dell'utente di appartenenza associato all'identificatore univoco specificato.
public:
static System::Web::Security::MembershipUser ^ GetUser(System::Object ^ providerUserKey);
public static System.Web.Security.MembershipUser GetUser (object providerUserKey);
static member GetUser : obj -> System.Web.Security.MembershipUser
Public Shared Function GetUser (providerUserKey As Object) As MembershipUser
Parametri
- providerUserKey
- Object
Identificatore univoco dell'utente, ottenuto dall'origine dati di appartenenze dell'utente.
Restituisce
Oggetto MembershipUser che rappresenta l'utente associato all'identificatore univoco specificato.
Eccezioni
providerUserKey
è null
.
Commenti
Il GetUser metodo recupera le informazioni utente dall'origine dati e crea un MembershipUser oggetto popolato con i dati restituiti. L'utente viene identificato usando l'identificatore univoco dell'origine dati specificata usando il providerUserKey
parametro .
È anche possibile specificare se si desidera GetUser aggiornare il timestamp di data/ora dell'ultima attività per l'utente recuperato con il userIsOnline
parametro .
GetUser Degli overload che non accettano un userIsOnline
parametro, GetUser()
aggiorna in modo implicito il timestamp di data/ora dell'ultima attività per l'utente.
GetUser(System.String)
e GetUser(System.Object)
non