CreateUserWizard.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 라는 텍스트 파일이 필요합니다.

Your account was set up on our Web site with the following:

    Username:   <%UserName%>

To reset your password, you must answer the following question:

    Password Question: <%PasswordQuestion%>
    Password Answer:   <%PasswordAnswer%>

Thank you for creating an account with our Web site.

<%@ 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 Createuserwizard1_SendingMail(object sender, MailMessageEventArgs e)
  {
    // Set MailMessage fields.
    e.Message.IsBodyHtml = false;
    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("<%PasswordQuestion%>", Createuserwizard1.Question);
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer);  
}
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </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 Createuserwizard1_SendingMail(ByVal sender As Object, ByVal e As MailMessageEventArgs)
    ' Set MailMessage fields.
    e.Message.IsBodyHtml = False
    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("<%PasswordQuestion%>", Createuserwizard1.Question)
    e.Message.Body = e.Message.Body.Replace("<%PasswordAnswer%>",   Createuserwizard1.Answer)
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.MailDefinition sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="Createuserwizard1" runat="server" 
          maildefinition-bodyfilename="MailFile.txt"
          maildefinition-from="userAdmin@your.site.name.here" 
          onsendingmail="Createuserwizard1_SendingMail">
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

설명

속성은 MailDefinition 새 사용자에게 전송되는 전자 메일 메시지의 형식과 콘텐츠를 정의하는 데 사용하는 속성 그룹에 대한 참조를 반환합니다. 일반 설정 제목 줄 및 보낸 사람의 반환 주소를 포함 합니다. 속성의 전체 목록은 참조 하세요.를 MailDefinition 클래스입니다.

합니다 MailDefinition 속성은 읽기 전용;의 속성을 설정할 수 있지만 MailDefinition 개체를 반환 합니다. 형식에서 MailDefinitionProperty-Subproperty선언적으로 속성을 설정할 수 있습니다. 여기서 Subproperty 는 클래스의 속성(예: MailDefinition-Subject)을 MailDefinition 나타냅니다. 형태로 속성을 프로그래밍 방식으로 설정할 수도 있습니다 Property.SubProperty (예를 들어 MailDefinition.Subject).

전자 메일 메시지는 이 아닌 null 경우에만 MailDefinition 새 사용자에게 전송되고 가 비어 null있지 않거나 이 아닌 경우에만 Body 전송됩니다. 이 경우 SendingMail 이벤트가 발생하고 전자 메일 메시지를 보내려고 시도합니다. 속성은 From 이메일 주소로 설정해야 합니다. 그렇지 않으면 예외가 HttpException throw됩니다.

개체에서 MailDefinition 전자 메일 메시지를 만들면 다음 표에 나열된 대체 메시지가 만들어집니다.

대체 텍스트 으로 대체
<%UserName%> 새로 만든 사용자 계정의 사용자 이름입니다.
<%Password%> 새로 만든 사용자 계정의 암호입니다.

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

메서드를 OnSendingMail 사용하여 개체에서 만든 을 MailMessage 수정할 MailDefinition 수 있습니다.

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

참고

사용자는 수신 보거나 전자 메일 메시지를 보장 하는 것이 불가능 합니다. 사용자가 전자 메일로 알림을 받았는지 확인하려면 사용자가 알림을 받았는지 확인할 수 있도록 이메일 메시지에 확인 링크를 제공하는 것이 좋습니다.

적용 대상

추가 정보