ChangePassword.MailDefinition 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

자신의 암호를 변경한 사용자에게 전달되는 이메일 메시지를 정의하는 속성의 컬렉션에 대한 참조를 가져옵니다.

public:
 property System::Web::UI::WebControls::MailDefinition ^ MailDefinition { System::Web::UI::WebControls::MailDefinition ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.Themeable(false)]
public System.Web.UI.WebControls.MailDefinition MailDefinition { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.Themeable(false)>]
member this.MailDefinition : System.Web.UI.WebControls.MailDefinition
Public ReadOnly Property MailDefinition As MailDefinition

속성 값

MailDefinition

에 대 한 참조를 MailDefinition 새 사용자에 게 전자 메일 메시지를 정의 하는 개체를 전송 합니다.

특성
PersistenceModeAttribute ThemeableAttribute

예외

HttpException

From 속성을 이메일 주소로 설정하지 않은 경우

예제

다음 코드 예제를 사용 하는 방법을 보여 줍니다는 MailDefinition 자신의 암호를 변경 하는 사용자에 게 전송 되는 전자 메일 메시지를 정의 하는 속성입니다. 라는 파일 임을 가정 MailFile.txt 보낼 전자 메일 메시지의 텍스트를 포함 하는 합니다.

사용자에 게 전자 메일 메시지를 보낼 수, 애플리케이션에 대 한 Web.config 파일에서 전자 메일 서버를 구성 해야 합니다. 자세한 내용은 방법: IIS 6.0에서 SMTP 가상 서버 설치 및 구성을 참조하세요.

<%@ 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">
  void Changepassword1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set mail message fields.
    e.Message.Subject = "New user on Web site.";
    // Replace placeholder text in message body with
    // information provided by the user.
    e.Message.Body = e.Message.Body.Replace("<%ChangedDate%>", (DateTime.Now.ToString()) );
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server" 
        maildefinition-bodyfilename="~/MailFiles/mailfile.txt" 
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </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">
  Sub Changepassword1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
        ' Set mail message fields.
        e.Message.Subject = "New user on Web site."
        ' Replace placeholder text in message body with information 
        '  provided by the user. 
        e.Message.Body = e.Message.Body.Replace("<%ChangedDate%>", DateTime.Now.ToString())
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:changepassword id="Changepassword1" runat="server" 
          maildefinition-bodyfilename="~/MailFiles/mailfile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Changepassword1_SendingMail">
      </asp:changepassword>
    </div>
    </form>
</body>
</html>

설명

MailDefinition 속성 형식을 정의 하는 데 사용 하는 속성의 그룹 및 암호가 변경 된 후 사용자에 게 보낸 전자 메일 메시지의 내용에 대 한 참조를 반환 합니다. 일반 설정 제목 줄 및 보낸 사람의 반환 주소를 포함 합니다. 속성의 전체 목록은 MailDefinition를 참조하십시오.

합니다 MailDefinition 속성은 읽기 전용;의 속성을 설정할 수 있지만 MailDefinition 개체를 반환 합니다. 이러한 속성은 양식 속성-하위 속성에서 설정할 수 있습니다. 여기서 하위 속성은 클래스의 속성(예: MailDefinition-Subject)을 MailDefinition 나타냅니다. 속성하위 속성형식.(예MailDefinition.Subject: )에서 속성을 프로그래밍 방식으로 설정할 수도 있습니다.

전자 메일 메시지가 전송 되는 경우에 사용자가 멤버 자격 공급자를 사용 하 여 등록 된 전자 메일 주소 및 경우에는 BodyFileName 의 속성은 MailDefinition 속성이 올바른 파일을 가리키는 합니다. 경우는 BodyFileName 속성을 설정 합니다 From 전자 메일 주소로; 속성을 설정 해야이 고, 그렇지는 HttpException 예외가 throw 됩니다.

전자 메일 메시지를 작성 하는 경우는 MailDefinition 개체를 다음 표에 나와 있는 대체를 확인 합니다. 대체 텍스트는 대/소문자입니다.

대체 텍스트 으로 대체
<%UserName%> 사용자의 웹 사이트 사용자 이름입니다.
<%Password%> 사용자에 대 한 새 암호입니다.

경우는 IsBodyHtml 의 속성을 MailDefinition 개체가 true, 메일 메시지의 내용을 HTML로 인코딩된 메시지 받는 사람에 대 한 사이트 간 스크립팅 보안 취약점 으로부터 보호 됩니다.

사용할 수는 SendingMail 수정 하는 이벤트를 MailMessage 으로 만들어진 개체는 MailDefinition 개체입니다.

중요

사용자 계정 이름 또는 전자 메일의 암호는 잠재적인 보안 위협을 보내는 중입니다. 전자 메일 메시지를 일반적으로 일반 텍스트로 보내고 애플리케이션 "스니핑" 하는 특수 한 네트워크에서 읽을 수 있습니다. 보안을 강화 하려면에 설명 된 완화 요소를 사용 하 여 보안 로그인 컨트롤합니다.

이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.

적용 대상

추가 정보