mcs/class/System/System.Net.Mail/MailMessage.cs

   1 //
   2 // System.Net.Mail.MailMessage.cs
   3 //
   4 // Author:
   5 //      Tim Coleman (tim@timcoleman.com)
   6 //
   7 // Copyright (C) Tim Coleman, 2004
   8 //
   9
  10 //
  11 // Permission is hereby granted, free of charge, to any person obtaining
  12 // a copy of this software and associated documentation files (the
  13 // "Software"), to deal in the Software without restriction, including
  14 // without limitation the rights to use, copy, modify, merge, publish,
  15 // distribute, sublicense, and/or sell copies of the Software, and to
  16 // permit persons to whom the Software is furnished to do so, subject to
  17 // the following conditions:
  18 //
  19 // The above copyright notice and this permission notice shall be
  20 // included in all copies or substantial portions of the Software.
  21 //
  22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  29 //
  30
  31 using System.Collections.Specialized;
  32 using System.Globalization;
  33 using System.Net.Mime;
  34 using System.Text;
  35
  36 namespace System.Net.Mail {
  37         public class MailMessage : IDisposable
  38         {
  39                 #region Fields
  40
  41                 AlternateViewCollection alternateViews;
  42                 AttachmentCollection attachments;
  43                 MailAddressCollection bcc;
  44                 MailAddressCollection replyTo;
  45                 string body;
  46                 MailPriority priority;
  47                 MailAddress sender;
  48                 DeliveryNotificationOptions deliveryNotificationOptions;
  49                 MailAddressCollection cc;
  50                 MailAddress from;
  51                 NameValueCollection headers;
  52                 MailAddressCollection to;
  53                 string subject;
  54                 Encoding subjectEncoding, bodyEncoding, headersEncoding = Encoding.UTF8;
  55                 bool isHtml;
  56
  57                 #endregion // Fields
  58
  59                 #region Constructors
  60
  61                 public MailMessage () {
  62                         this.to = new MailAddressCollection ();
  63
  64                         alternateViews = new AlternateViewCollection ();
  65                         attachments = new AttachmentCollection ();
  66                         bcc = new MailAddressCollection ();
  67                         cc = new MailAddressCollection ();
  68                         replyTo = new MailAddressCollection ();
  69                         headers = new NameValueCollection ();
  70
  71                         headers.Add ("MIME-Version", "1.0");
  72                 }
  73
  74                 // FIXME: should it throw a FormatException if the addresses are wrong?
  75                 // (How is it possible to instantiate such a malformed MailAddress?)
  76                 public MailMessage (MailAddress from, MailAddress to) : this ()
  77                 {
  78                         if (from == null || to == null)
  79                                 throw new ArgumentNullException ();
  80
  81                         From = from;
  82
  83                         this.to.Add (to);
  84                 }
  85
  86                 public MailMessage (string from, string to) : this ()
  87                 {
  88                         if (from == null || from == String.Empty)
  89                                 throw new ArgumentNullException ("from");
  90                         if (to == null || to == String.Empty)
  91                                 throw new ArgumentNullException ("to");
  92
  93                         this.from = new MailAddress (from);
  94                         foreach (string recipient in to.Split (new char [] {','}))
  95                                 this.to.Add (new MailAddress (recipient.Trim ()));
  96                 }
  97
  98                 public MailMessage (string from, string to, string subject, string body) : this ()
  99                 {
 100                         if (from == null || from == String.Empty)
 101                                 throw new ArgumentNullException ("from");
 102                         if (to == null || to == String.Empty)
 103                                 throw new ArgumentNullException ("to");
 104
 105                         this.from = new MailAddress (from);
 106                         foreach (string recipient in to.Split (new char [] {','}))
 107                                 this.to.Add (new MailAddress (recipient.Trim ()));
 108
 109                         Body = body;
 110                         Subject = subject;
 111                 }
 112
 113                 #endregion // Constructors
 114
 115                 #region Properties
 116
 117                 public AlternateViewCollection AlternateViews {
 118                         get { return alternateViews; }
 119                 }
 120
 121                 public AttachmentCollection Attachments {
 122                         get { return attachments; }
 123                 }
 124
 125                 public MailAddressCollection Bcc {
 126                         get { return bcc; }
 127                 }
 128
 129                 public string Body {
 130                         get { return body; }
 131                         set {
 132                                 // autodetect suitable body encoding (ASCII or UTF-8), if it is not initialized yet.
 133                                 if (value != null && bodyEncoding == null)
 134                                         bodyEncoding = GuessEncoding (value) ?? Encoding.ASCII;
 135                                 body = value;
 136                         }
 137                 }
 138
 139                 internal ContentType BodyContentType {
 140                         get {
 141                                 ContentType ct = new ContentType (isHtml ? "text/html" : "text/plain");
 142                                 ct.CharSet = (BodyEncoding ?? Encoding.ASCII).HeaderName;
 143                                 return ct;
 144                         }
 145                 }
 146
 147                 internal TransferEncoding ContentTransferEncoding {
 148                         get { return ContentType.GuessTransferEncoding (BodyEncoding); }
 149                 }
 150
 151                 public Encoding BodyEncoding {
 152                         get { return bodyEncoding; }
 153                         set { bodyEncoding = value; }
 154                 }
 155
 156                 public MailAddressCollection CC {
 157                         get { return cc; }
 158                 }
 159
 160                 public DeliveryNotificationOptions DeliveryNotificationOptions {
 161                         get { return deliveryNotificationOptions; }
 162                         set { deliveryNotificationOptions = value; }
 163                 }
 164
 165                 public MailAddress From {
 166                         get { return from; }
 167                         set { from = value; }
 168                 }
 169
 170                 public NameValueCollection Headers {
 171                         get { return headers; }
 172                 }
 173
 174                 public bool IsBodyHtml {
 175                         get { return isHtml; }
 176                         set { isHtml = value; }
 177                 }
 178
 179                 public MailPriority Priority {
 180                         get { return priority; }
 181                         set { priority = value; }
 182                 }
 183
 184 #if NET_4_0
 185                 public
 186 #else
 187                 internal
 188 #endif
 189                 Encoding HeadersEncoding {
 190                         get { return headersEncoding; }
 191                         set { headersEncoding = value; }
 192                 }
 193
 194 #if NET_4_0
 195                 public
 196 #else
 197                 internal
 198 #endif
 199                 MailAddressCollection ReplyToList {
 200                         get { return replyTo; }
 201                 }
 202
 203 #if NET_4_0
 204                 [Obsolete ("Use ReplyToList instead")]
 205 #endif
 206                 public MailAddress ReplyTo {
 207                         get {
 208                                 if (replyTo.Count == 0)
 209                                         return null;
 210                                 return replyTo [0];
 211                         }
 212                         set {
 213                                 replyTo.Clear ();
 214                                 replyTo.Add (value);
 215                         }
 216                 }
 217
 218                 public MailAddress Sender {
 219                         get { return sender; }
 220                         set { sender = value; }
 221                 }
 222
 223                 public string Subject {
 224                         get { return subject; }
 225                         set {
 226                                 if (value != null && subjectEncoding == null)
 227                                         subjectEncoding = GuessEncoding (value);
 228                                 subject = value;
 229                         }
 230                 }
 231
 232                 public Encoding SubjectEncoding {
 233                         get { return subjectEncoding; }
 234                         set { subjectEncoding = value; }
 235                 }
 236
 237                 public MailAddressCollection To {
 238                         get { return to; }
 239                 }
 240
 241                 #endregion // Properties
 242
 243                 #region Methods
 244
 245                 public void Dispose ()
 246                 {
 247                         Dispose (true);
 248                         GC.SuppressFinalize (this);
 249                 }
 250
 251                 protected virtual void Dispose (bool disposing)
 252                 {
 253                 }
 254
 255                 private Encoding GuessEncoding (string s)
 256                 {
 257                         return ContentType.GuessEncoding (s);
 258                 }
 259
 260                 #endregion // Methods
 261         }
 262 }
 263