Membership.GetUserNameByEmail(String) Método
Definição
Obtém um nome de usuário em que o endereço de email do usuário corresponde ao endereço de email especificado.Gets a user name where the email address for the user matches the specified email address.
public:
static System::String ^ GetUserNameByEmail(System::String ^ emailToMatch);
public static string GetUserNameByEmail (string emailToMatch);
static member GetUserNameByEmail : string -> string
Public Shared Function GetUserNameByEmail (emailToMatch As String) As String
Parâmetros
- emailToMatch
- String
O endereço de email a ser pesquisado.The email address to search for.
Retornos
O nome de usuário em que o endereço de email do usuário corresponde ao endereço de email especificado.The user name where the email address for the user matches the specified email address. Se nenhuma correspondência for encontrada, null será retornado.If no match is found, null is returned.
Exemplos
O exemplo de código a seguir recupera o nome de usuário para um endereço de email especificado.The following code example retrieves the user name for a specified email address.
Importante
Este exemplo contém uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança.This example contains a text box that accepts user input, which is a potential security threat. Por padrão, as páginas da Web do ASP.NET validam que a entrada do usuário não inclui elementos de script ou HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.
<%@ 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">
public void Search_OnClick(object sender, EventArgs args)
{
string username = Membership.GetUserNameByEmail(EmailTextBox.Text);
if (username == null)
{
Msg.Text = "Email address " + Server.HtmlEncode(EmailTextBox.Text) + " is not found. Please reenter.";
}
else
{
Msg.Text = "The user name for " + Server.HtmlEncode(EmailTextBox.Text) +
" is " + Server.HtmlEncode(username) + ".";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Retrieve Username By Email</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Forgot your Username? Search for it by email address.</h3>
<asp:Label id="Msg" runat="server" ForeColor="maroon" /><br />
Email address: <asp:Textbox id="EmailTextBox" Columns="30" runat="server" />
<asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
ControlToValidate="EmailTextBox" ForeColor="red"
Display="Static" ErrorMessage="Required" /><br />
<asp:Button id="SearchButton" Text="Search"
OnClick="Search_OnClick" runat="server" />
</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">
Public Sub Search_OnClick(sender As Object, args As EventArgs)
Dim username As String = Membership.GetUserNameByEmail(EmailTextBox.Text)
If username Is Nothing Then
Msg.Text = "Email address " & Server.HtmlEncode(EmailTextBox.Text) & " is not found. Please reenter."
Else
Msg.Text = "The user name for " & Server.HtmlEncode(EmailTextBox.Text) & _
" is " & Server.HtmlEncode(username) & "."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Retrieve Username By Email</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Forgot your Username? Search for it by email address.</h3>
<asp:Label id="Msg" runat="server" ForeColor="maroon" /><br />
Email address: <asp:Textbox id="EmailTextBox" Columns="30" runat="server" />
<asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
ControlToValidate="EmailTextBox" ForeColor="red"
Display="Static" ErrorMessage="Required" /><br />
<asp:Button id="SearchButton" Text="Search"
OnClick="Search_OnClick" runat="server" />
</form>
</body>
</html>
Comentários
GetUserNameByEmail pode ser usado para recuperar o nome de usuário para um usuário da associação no caso em que um usuário não souber seu nome de usuário, mas souber seu endereço de email.GetUserNameByEmail can be used to retrieve the user name for a membership user in the case where a user does not know their user name, but does know their email address. Se mais de um usuário no repositório de dados tiver o mesmo endereço de email, o primeiro nome de usuário encontrado será retornado.If more than one user in the data store has the same email address, the first user name encountered is returned.
Espaços à esquerda e à direita são cortados de todos os valores de parâmetro.Leading and trailing spaces are trimmed from all parameter values.