Merge pull request #5714 from alexischr/update_bockbuild
[mono.git] / mcs / class / System / Documentation / en / System.Net.Mail / MailMessage.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <Type Name="MailMessage" FullName="System.Net.Mail.MailMessage">
3   <TypeSignature Language="C#" Value="public class MailMessage : IDisposable" />
4   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit MailMessage extends System.Object implements class System.IDisposable" />
5   <AssemblyInfo>
6     <AssemblyName>System</AssemblyName>
7     <AssemblyVersion>2.0.0.0</AssemblyVersion>
8     <AssemblyVersion>4.0.0.0</AssemblyVersion>
9   </AssemblyInfo>
10   <Base>
11     <BaseTypeName>System.Object</BaseTypeName>
12   </Base>
13   <Interfaces>
14     <Interface>
15       <InterfaceName>System.IDisposable</InterfaceName>
16     </Interface>
17   </Interfaces>
18   <Docs>
19     <since version=".NET 2.0" />
20     <remarks>
21       <attribution license="cc4" from="Microsoft" modified="false" />
22       <para>Instances of the <see cref="T:System.Net.Mail.MailMessage" /> class are used to construct e-mail messages that are transmitted to an SMTP server for delivery using the <see cref="T:System.Net.Mail.SmtpClient" /> class. </para>
23       <para>The sender, recipient, subject, and body of an e-mail message may be specified as parameters when a <see cref="Overload:System.Net.Mail.MailMessage.#ctor" /> is used to initialize a <see cref="T:System.Net.Mail.MailMessage" /> object. These parameters may also be set or accessed using properties on the <see cref="T:System.Net.Mail.MailMessage" /> object.</para>
24       <para>The primary mail message headers and elements for the message may be set using the following properties of the <see cref="T:System.Net.Mail.MailMessage" /> class.</para>
25       <list type="table">
26         <listheader>
27           <item>
28             <term>
29               <para>Mail header or part</para>
30             </term>
31             <description>
32               <para>Property</para>
33             </description>
34           </item>
35         </listheader>
36         <item>
37           <term>
38             <para>Attachments</para>
39           </term>
40           <description>
41             <para>
42               <see cref="P:System.Net.Mail.MailMessage.Attachments" />
43             </para>
44           </description>
45         </item>
46         <item>
47           <term>
48             <para>Blind carbon copies (BCC)</para>
49           </term>
50           <description>
51             <para>
52               <see cref="P:System.Net.Mail.MailMessage.Bcc" />
53             </para>
54           </description>
55         </item>
56         <item>
57           <term>
58             <para>Carbon copies (CC)</para>
59           </term>
60           <description>
61             <para>
62               <see cref="P:System.Net.Mail.MailMessage.CC" />
63             </para>
64           </description>
65         </item>
66         <item>
67           <term>
68             <para>Content-Type</para>
69           </term>
70           <description>
71             <para>
72               <see cref="P:System.Net.Mail.MailMessage.BodyEncoding" />
73             </para>
74           </description>
75         </item>
76         <item>
77           <term>
78             <para>Encoding for custom headers</para>
79           </term>
80           <description>
81             <para>
82               <see cref="P:System.Net.Mail.MailMessage.HeadersEncoding" />
83             </para>
84           </description>
85         </item>
86         <item>
87           <term>
88             <para>Message body</para>
89           </term>
90           <description>
91             <para>
92               <see cref="P:System.Net.Mail.MailMessage.Body" />
93             </para>
94           </description>
95         </item>
96         <item>
97           <term>
98             <para>Priority</para>
99           </term>
100           <description>
101             <para>
102               <see cref="P:System.Net.Mail.MailMessage.Priority" />
103             </para>
104           </description>
105         </item>
106         <item>
107           <term>
108             <para>Recipient</para>
109           </term>
110           <description>
111             <para>
112               <see cref="P:System.Net.Mail.MailMessage.To" />
113             </para>
114           </description>
115         </item>
116         <item>
117           <term>
118             <para>Reply-To</para>
119           </term>
120           <description>
121             <para>
122               <see cref="P:System.Net.Mail.MailMessage.ReplyToList" />
123             </para>
124           </description>
125         </item>
126         <item>
127           <term>
128             <para>Sender</para>
129           </term>
130           <description>
131             <para>
132               <see cref="P:System.Net.Mail.MailMessage.From" />
133             </para>
134           </description>
135         </item>
136         <item>
137           <term>
138             <para>Subject</para>
139           </term>
140           <description>
141             <para>
142               <see cref="P:System.Net.Mail.MailMessage.Subject" />
143             </para>
144           </description>
145         </item>
146       </list>
147       <para>The <see cref="T:System.Net.Mail.MailMessage" /> class also allows an application to access the headers collection for the message using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property. While this collection is read-only (a new collection can not be set), custom headers can be added to or deleted from this collection. Any custom headers added will be included when the <see cref="T:System.Net.Mail.MailMessage" /> instance is sent. Before a message is sent, only headers specifically added to this collection in the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property are included in the collection. After a the <see cref="T:System.Net.Mail.MailMessage" /> instance is sent, the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property will also include headers that are set using the associated properties of the <see cref="T:System.Net.Mail.MailMessage" /> class or parameters passed when a <see cref="Overload:System.Net.Mail.MailMessage.#ctor" /> is used to initialize a <see cref="T:System.Net.Mail.MailMessage" /> object.</para>
148       <para>If some mail headers are malformed, they could cause the email message to become corrupted. So any mail header in the headers collection that can be set using a property on the <see cref="T:System.Net.Mail.MailMessage" /> class should only be set using the <see cref="T:System.Net.Mail.MailMessage" /> class property or as a parameter passed when a <see cref="Overload:System.Net.Mail.MailMessage.#ctor" /> initializes a <see cref="T:System.Net.Mail.MailMessage" /> object. The following list of mail headers should not be added using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property and any values set for these headers using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property will be discarded or overwritten when the message is sent:</para>
149       <list type="bullet">
150         <item>
151           <para>Bcc</para>
152         </item>
153         <item>
154           <para>Cc</para>
155         </item>
156         <item>
157           <para>Content-ID</para>
158         </item>
159         <item>
160           <para>Content-Location</para>
161         </item>
162         <item>
163           <para>Content-Transfer-Encoding</para>
164         </item>
165         <item>
166           <para>Content-Type</para>
167         </item>
168         <item>
169           <para>Date</para>
170         </item>
171         <item>
172           <para>From</para>
173         </item>
174         <item>
175           <para>Importance</para>
176         </item>
177         <item>
178           <para>MIME-Version</para>
179         </item>
180         <item>
181           <para>Priority</para>
182         </item>
183         <item>
184           <para>Reply-To</para>
185         </item>
186         <item>
187           <para>Sender</para>
188         </item>
189         <item>
190           <para>To</para>
191         </item>
192         <item>
193           <para>X-Priority</para>
194         </item>
195       </list>
196       <para>If the application does not specify an X-Sender header using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property, the <see cref="T:System.Net.Mail.MailMessage" /> class will create one when the message is sent. </para>
197       <para>Use the <see cref="P:System.Net.Mail.MailMessage.AlternateViews" /> property to specify copies of an e-mail message in different formats. For example, if you send a message in HTML, you might also want to provide a plain text version in case some of the recipients use e-mail readers that cannot display HTML content. For an example that demonstrates creating a message with alternate views, see <see cref="P:System.Net.Mail.MailMessage.AlternateViews" />.</para>
198       <para>Use the <see cref="P:System.Net.Mail.MailMessage.Attachments" /> property to add attachments to an e-mail message. For an example that demonstrates creating a message with an attachment, see <see cref="P:System.Net.Mail.MailMessage.Attachments" />.</para>
199       <para>After assembling your e-mail message, you can send it by using the <see cref="M:System.Net.Mail.SmtpClient.Send(System.Net.Mail.MailMessage)" /> or <see cref="Overload:System.Net.Mail.SmtpClient.SendAsync" /> methods. </para>
200     </remarks>
201     <summary>
202       <attribution license="cc4" from="Microsoft" modified="false" />
203       <para>Represents an e-mail message that can be sent using the <see cref="T:System.Net.Mail.SmtpClient" /> class.</para>
204     </summary>
205   </Docs>
206   <Members>
207     <Member MemberName=".ctor">
208       <MemberSignature Language="C#" Value="public MailMessage ();" />
209       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
210       <MemberType>Constructor</MemberType>
211       <AssemblyInfo>
212         <AssemblyVersion>2.0.0.0</AssemblyVersion>
213         <AssemblyVersion>4.0.0.0</AssemblyVersion>
214       </AssemblyInfo>
215       <Parameters />
216       <Docs>
217         <since version=".NET 2.0" />
218         <remarks>
219           <attribution license="cc4" from="Microsoft" modified="false" />
220           <para>From is set to the value in the network element for mailSettings<format type="text/html"><a href="220b0329-e384-4e0c-86b4-0945ad17efd9"></a></format>, if it exists.</para>
221         </remarks>
222         <summary>
223           <attribution license="cc4" from="Microsoft" modified="false" />
224           <para>Initializes an empty instance of the <see cref="T:System.Net.Mail.MailMessage" /> class.</para>
225         </summary>
226       </Docs>
227     </Member>
228     <Member MemberName=".ctor">
229       <MemberSignature Language="C#" Value="public MailMessage (System.Net.Mail.MailAddress from, System.Net.Mail.MailAddress to);" />
230       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Net.Mail.MailAddress from, class System.Net.Mail.MailAddress to) cil managed" />
231       <MemberType>Constructor</MemberType>
232       <AssemblyInfo>
233         <AssemblyVersion>2.0.0.0</AssemblyVersion>
234         <AssemblyVersion>4.0.0.0</AssemblyVersion>
235       </AssemblyInfo>
236       <Parameters>
237         <Parameter Name="from" Type="System.Net.Mail.MailAddress" />
238         <Parameter Name="to" Type="System.Net.Mail.MailAddress" />
239       </Parameters>
240       <Docs>
241         <since version=".NET 2.0" />
242         <remarks>
243           <attribution license="cc4" from="Microsoft" modified="false" />
244           <para>The <see cref="P:System.Net.Mail.MailMessage.From" /> property is initialized using <paramref name="from" /> and the <see cref="P:System.Net.Mail.MailMessage.To" /> property is initialized using <paramref name="to" />.</para>
245         </remarks>
246         <summary>
247           <attribution license="cc4" from="Microsoft" modified="false" />
248           <para>Initializes a new instance of the <see cref="T:System.Net.Mail.MailMessage" /> class by using the specified <see cref="T:System.Net.Mail.MailAddress" /> class objects. </para>
249         </summary>
250         <param name="from">
251           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Mail.MailAddress" /> that contains the address of the sender of the e-mail message.</param>
252         <param name="to">
253           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Mail.MailAddress" /> that contains the address of the recipient of the e-mail message.</param>
254       </Docs>
255     </Member>
256     <Member MemberName=".ctor">
257       <MemberSignature Language="C#" Value="public MailMessage (string from, string to);" />
258       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string from, string to) cil managed" />
259       <MemberType>Constructor</MemberType>
260       <AssemblyInfo>
261         <AssemblyVersion>2.0.0.0</AssemblyVersion>
262         <AssemblyVersion>4.0.0.0</AssemblyVersion>
263       </AssemblyInfo>
264       <Parameters>
265         <Parameter Name="from" Type="System.String" />
266         <Parameter Name="to" Type="System.String" />
267       </Parameters>
268       <Docs>
269         <since version=".NET 2.0" />
270         <remarks>
271           <attribution license="cc4" from="Microsoft" modified="false" />
272           <para>The <see cref="P:System.Net.Mail.MailMessage.From" /> property is initialized using <paramref name="from" /> and the <see cref="P:System.Net.Mail.MailMessage.To" /> property is initialized using <paramref name="to" />.</para>
273         </remarks>
274         <summary>
275           <attribution license="cc4" from="Microsoft" modified="false" />
276           <para>Initializes a new instance of the <see cref="T:System.Net.Mail.MailMessage" /> class by using the specified <see cref="T:System.String" /> class objects. </para>
277         </summary>
278         <param name="from">
279           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the address of the sender of the e-mail message.</param>
280         <param name="to">
281           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the addresses of the recipients of the e-mail message.</param>
282       </Docs>
283     </Member>
284     <Member MemberName=".ctor">
285       <MemberSignature Language="C#" Value="public MailMessage (string from, string to, string subject, string body);" />
286       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string from, string to, string subject, string body) cil managed" />
287       <MemberType>Constructor</MemberType>
288       <AssemblyInfo>
289         <AssemblyVersion>2.0.0.0</AssemblyVersion>
290         <AssemblyVersion>4.0.0.0</AssemblyVersion>
291       </AssemblyInfo>
292       <Parameters>
293         <Parameter Name="from" Type="System.String" />
294         <Parameter Name="to" Type="System.String" />
295         <Parameter Name="subject" Type="System.String" />
296         <Parameter Name="body" Type="System.String" />
297       </Parameters>
298       <Docs>
299         <since version=".NET 2.0" />
300         <remarks>
301           <attribution license="cc4" from="Microsoft" modified="false" />
302           <para>The properties for the new <see cref="T:System.Net.Mail.MailMessage" /> object are initialized as follows:</para>
303           <list type="table">
304             <listheader>
305               <item>
306                 <term>
307                   <para>Parameter</para>
308                 </term>
309                 <description>
310                   <para>Property</para>
311                 </description>
312               </item>
313             </listheader>
314             <item>
315               <term>
316                 <para>
317                   <paramref name="from" />
318                 </para>
319               </term>
320               <description>
321                 <para>
322                   <see cref="P:System.Net.Mail.MailMessage.From" />
323                 </para>
324               </description>
325             </item>
326             <item>
327               <term>
328                 <list type="bullet">
329                   <item>
330                     <para>
331                       <paramref name="to" />
332                     </para>
333                   </item>
334                 </list>
335               </term>
336               <description>
337                 <list type="bullet">
338                   <item>
339                     <para>
340                       <see cref="P:System.Net.Mail.MailMessage.To" />
341                     </para>
342                   </item>
343                 </list>
344               </description>
345             </item>
346             <item>
347               <term>
348                 <list type="bullet">
349                   <item>
350                     <para>
351                       <paramref name="subject" />
352                     </para>
353                   </item>
354                 </list>
355               </term>
356               <description>
357                 <list type="bullet">
358                   <item>
359                     <para>
360                       <see cref="P:System.Net.Mail.MailMessage.Subject" />
361                     </para>
362                   </item>
363                 </list>
364               </description>
365             </item>
366             <item>
367               <term>
368                 <list type="bullet">
369                   <item>
370                     <para>
371                       <paramref name="body" />
372                     </para>
373                   </item>
374                 </list>
375               </term>
376               <description>
377                 <list type="bullet">
378                   <item>
379                     <para>
380                       <see cref="P:System.Net.Mail.MailMessage.Body" />
381                     </para>
382                   </item>
383                 </list>
384               </description>
385             </item>
386           </list>
387           <para>By default, the subject and content are assumed to use the default encoding based on local computer settings. Use the <see cref="P:System.Net.Mail.MailMessage.BodyEncoding" /> and <see cref="P:System.Net.Mail.MailMessage.SubjectEncoding" /> properties to specify different encodings.</para>
388         </remarks>
389         <summary>
390           <attribution license="cc4" from="Microsoft" modified="false" />
391           <para>Initializes a new instance of the <see cref="T:System.Net.Mail.MailMessage" /> class. </para>
392         </summary>
393         <param name="from">
394           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the address of the sender of the e-mail message.</param>
395         <param name="to">
396           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the address of the recipient of the e-mail message.</param>
397         <param name="subject">
398           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the subject text.</param>
399         <param name="body">
400           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the message body.</param>
401       </Docs>
402     </Member>
403     <Member MemberName="AlternateViews">
404       <MemberSignature Language="C#" Value="public System.Net.Mail.AlternateViewCollection AlternateViews { get; }" />
405       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.AlternateViewCollection AlternateViews" />
406       <MemberType>Property</MemberType>
407       <AssemblyInfo>
408         <AssemblyVersion>2.0.0.0</AssemblyVersion>
409         <AssemblyVersion>4.0.0.0</AssemblyVersion>
410       </AssemblyInfo>
411       <ReturnValue>
412         <ReturnType>System.Net.Mail.AlternateViewCollection</ReturnType>
413       </ReturnValue>
414       <Docs>
415         <value>To be added.</value>
416         <since version=".NET 2.0" />
417         <remarks>
418           <attribution license="cc4" from="Microsoft" modified="false" />
419           <para>Use the <see cref="P:System.Net.Mail.MailMessage.AlternateViews" /> property to specify copies of an e-mail message in different formats. For example, if you send a message in HTML, you might also want to provide a plain text version in case some of the recipients use e-mail readers that cannot display HTML content.</para>
420           <para>To add an alternate view to a <see cref="T:System.Net.Mail.MailMessage" /> object, create an <see cref="T:System.Net.Mail.Attachment" /> for the view, and then add it to the collection returned by <see cref="P:System.Net.Mail.MailMessage.AlternateViews" />. Use the <see cref="P:System.Net.Mail.MailMessage.Body" /> property to specify the text version and use the <see cref="P:System.Net.Mail.MailMessage.AlternateViews" /> collection to specify views with other MIME types. Use the <see cref="T:System.Net.Mime.MediaTypeNames" /> class members to specify the MIME type for the alternate view.</para>
421         </remarks>
422         <summary>
423           <attribution license="cc4" from="Microsoft" modified="false" />
424           <para>Gets the attachment collection used to store alternate forms of the message body.</para>
425         </summary>
426       </Docs>
427     </Member>
428     <Member MemberName="Attachments">
429       <MemberSignature Language="C#" Value="public System.Net.Mail.AttachmentCollection Attachments { get; }" />
430       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.AttachmentCollection Attachments" />
431       <MemberType>Property</MemberType>
432       <AssemblyInfo>
433         <AssemblyVersion>2.0.0.0</AssemblyVersion>
434         <AssemblyVersion>4.0.0.0</AssemblyVersion>
435       </AssemblyInfo>
436       <ReturnValue>
437         <ReturnType>System.Net.Mail.AttachmentCollection</ReturnType>
438       </ReturnValue>
439       <Docs>
440         <value>To be added.</value>
441         <since version=".NET 2.0" />
442         <remarks>
443           <attribution license="cc4" from="Microsoft" modified="false" />
444           <para>Use the collection returned by the <see cref="P:System.Net.Mail.MailMessage.Attachments" /> property to add an attachment, such as a file or the contents of a <see cref="T:System.IO.Stream" />, to this <see cref="T:System.Net.Mail.MailMessage" />. </para>
445           <para>Create an <see cref="T:System.Net.Mail.Attachment" /> that contains or references the data to be attached, and then add the <see cref="T:System.Net.Mail.Attachment" /> to the collection returned by <see cref="P:System.Net.Mail.MailMessage.Attachments" />.</para>
446         </remarks>
447         <summary>
448           <attribution license="cc4" from="Microsoft" modified="false" />
449           <para>Gets the attachment collection used to store data attached to this e-mail message.</para>
450         </summary>
451       </Docs>
452     </Member>
453     <Member MemberName="Bcc">
454       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddressCollection Bcc { get; }" />
455       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddressCollection Bcc" />
456       <MemberType>Property</MemberType>
457       <AssemblyInfo>
458         <AssemblyVersion>2.0.0.0</AssemblyVersion>
459         <AssemblyVersion>4.0.0.0</AssemblyVersion>
460       </AssemblyInfo>
461       <ReturnValue>
462         <ReturnType>System.Net.Mail.MailAddressCollection</ReturnType>
463       </ReturnValue>
464       <Docs>
465         <value>To be added.</value>
466         <since version=".NET 2.0" />
467         <remarks>
468           <attribution license="cc4" from="Microsoft" modified="false" />
469           <para>To add a BCC recipient to an e-mail message, create a <see cref="T:System.Net.Mail.MailAddress" /> for the recipient's address, and then add that object to the collection returned by the <see cref="P:System.Net.Mail.MailMessage.Bcc" /> property.</para>
470           <para>When recipients view an e-mail message, the <see cref="P:System.Net.Mail.MailMessage.Bcc" /> addresses are usually not displayed.</para>
471         </remarks>
472         <summary>
473           <attribution license="cc4" from="Microsoft" modified="false" />
474           <para>Gets the address collection that contains the blind carbon copy (BCC) recipients for this e-mail message.</para>
475         </summary>
476       </Docs>
477     </Member>
478     <Member MemberName="Body">
479       <MemberSignature Language="C#" Value="public string Body { get; set; }" />
480       <MemberSignature Language="ILAsm" Value=".property instance string Body" />
481       <MemberType>Property</MemberType>
482       <AssemblyInfo>
483         <AssemblyVersion>2.0.0.0</AssemblyVersion>
484         <AssemblyVersion>4.0.0.0</AssemblyVersion>
485       </AssemblyInfo>
486       <ReturnValue>
487         <ReturnType>System.String</ReturnType>
488       </ReturnValue>
489       <Docs>
490         <value>To be added.</value>
491         <since version=".NET 2.0" />
492         <remarks>
493           <attribution license="cc4" from="Microsoft" modified="false" />
494           <para>The <see cref="T:System.Net.Mime.ContentType" /> of the <see cref="P:System.Net.Mail.MailMessage.Body" /> content is "text/plain". Specify the encoding used for the body with the <see cref="P:System.Net.Mail.MailMessage.BodyEncoding" /> property. </para>
495           <para>If the body content is available in alternative formats that provide richer presentation options for the recipients, you can specify alternate views for the body content by using the <see cref="P:System.Net.Mail.MailMessage.AlternateViews" /> property. For example, an application might choose to send both the plain text body and an HTML version of the message body. E-mail readers that can display HTML can present the HTML version of the body to the recipient, while readers that cannot display HTML will display the plain text version of the message instead.</para>
496         </remarks>
497         <summary>
498           <attribution license="cc4" from="Microsoft" modified="false" />
499           <para>Gets or sets the message body.</para>
500         </summary>
501       </Docs>
502     </Member>
503     <Member MemberName="BodyEncoding">
504       <MemberSignature Language="C#" Value="public System.Text.Encoding BodyEncoding { get; set; }" />
505       <MemberSignature Language="ILAsm" Value=".property instance class System.Text.Encoding BodyEncoding" />
506       <MemberType>Property</MemberType>
507       <AssemblyInfo>
508         <AssemblyVersion>2.0.0.0</AssemblyVersion>
509         <AssemblyVersion>4.0.0.0</AssemblyVersion>
510       </AssemblyInfo>
511       <ReturnValue>
512         <ReturnType>System.Text.Encoding</ReturnType>
513       </ReturnValue>
514       <Docs>
515         <value>To be added.</value>
516         <since version=".NET 2.0" />
517         <remarks>
518           <attribution license="cc4" from="Microsoft" modified="false" />
519           <para>The value specified for the <see cref="P:System.Net.Mail.MailMessage.BodyEncoding" /> property sets the character set field in the Content-Type header. The default character set is "us-ascii".</para>
520           <para>If you set the <see cref="P:System.Net.Mail.MailMessage.BodyEncoding" /> property to <see cref="P:System.Text.Encoding.UTF8" />, <see cref="P:System.Text.Encoding.Unicode" />, or <see cref="P:System.Text.Encoding.UTF32" />, the Framework selects a <see cref="T:System.Net.Mime.TransferEncoding" /> of <see cref="F:System.Net.Mime.TransferEncoding.Base64" /> for this <see cref="T:System.Net.Mail.MailMessage" />.</para>
521         </remarks>
522         <summary>
523           <attribution license="cc4" from="Microsoft" modified="false" />
524           <para>Gets or sets the encoding used to encode the message body.</para>
525         </summary>
526       </Docs>
527     </Member>
528     <Member MemberName="CC">
529       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddressCollection CC { get; }" />
530       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddressCollection CC" />
531       <MemberType>Property</MemberType>
532       <AssemblyInfo>
533         <AssemblyVersion>2.0.0.0</AssemblyVersion>
534         <AssemblyVersion>4.0.0.0</AssemblyVersion>
535       </AssemblyInfo>
536       <ReturnValue>
537         <ReturnType>System.Net.Mail.MailAddressCollection</ReturnType>
538       </ReturnValue>
539       <Docs>
540         <value>To be added.</value>
541         <since version=".NET 2.0" />
542         <remarks>
543           <attribution license="cc4" from="Microsoft" modified="false" />
544           <para>To add a CC recipient to an e-mail message, create a <see cref="T:System.Net.Mail.MailAddress" /> for the recipient's address and then add that object to the collection returned by the <see cref="P:System.Net.Mail.MailMessage.CC" /> property.</para>
545         </remarks>
546         <summary>
547           <attribution license="cc4" from="Microsoft" modified="false" />
548           <para>Gets the address collection that contains the carbon copy (CC) recipients for this e-mail message.</para>
549         </summary>
550       </Docs>
551     </Member>
552     <Member MemberName="DeliveryNotificationOptions">
553       <MemberSignature Language="C#" Value="public System.Net.Mail.DeliveryNotificationOptions DeliveryNotificationOptions { get; set; }" />
554       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.Net.Mail.DeliveryNotificationOptions DeliveryNotificationOptions" />
555       <MemberType>Property</MemberType>
556       <AssemblyInfo>
557         <AssemblyVersion>2.0.0.0</AssemblyVersion>
558         <AssemblyVersion>4.0.0.0</AssemblyVersion>
559       </AssemblyInfo>
560       <ReturnValue>
561         <ReturnType>System.Net.Mail.DeliveryNotificationOptions</ReturnType>
562       </ReturnValue>
563       <Docs>
564         <value>To be added.</value>
565         <remarks>To be added.</remarks>
566         <since version=".NET 2.0" />
567         <summary>
568           <attribution license="cc4" from="Microsoft" modified="false" />
569           <para>Gets or sets the delivery notifications for this e-mail message.</para>
570         </summary>
571       </Docs>
572     </Member>
573     <Member MemberName="Dispose">
574       <MemberSignature Language="C#" Value="public void Dispose ();" />
575       <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Dispose() cil managed" />
576       <MemberType>Method</MemberType>
577       <AssemblyInfo>
578         <AssemblyVersion>2.0.0.0</AssemblyVersion>
579         <AssemblyVersion>4.0.0.0</AssemblyVersion>
580       </AssemblyInfo>
581       <ReturnValue>
582         <ReturnType>System.Void</ReturnType>
583       </ReturnValue>
584       <Parameters />
585       <Docs>
586         <since version=".NET 2.0" />
587         <remarks>
588           <attribution license="cc4" from="Microsoft" modified="false" />
589           <para>Call the <see cref="M:System.Net.Mail.MailMessage.Dispose" /> method when you are finished using the <see cref="T:System.Net.Mail.MailMessage" />. The <see cref="M:System.Net.Mail.MailMessage.Dispose" /> method leaves the <see cref="T:System.Net.Mail.MailMessage" /> in an unusable state. After calling <see cref="M:System.Net.Mail.MailMessage.Dispose" />, you must release all references to the <see cref="T:System.Net.Mail.MailMessage" /> so the garbage collector can reclaim the memory that the <see cref="T:System.Net.Mail.MailMessage" /> was occupying. For more information, see <format type="text/html"><a href="a17b0066-71c2-4ba4-9822-8e19332fc213">Cleaning Up Unmanaged Resources</a></format> and <format type="text/html"><a href="eb4e1af0-3b48-4fbc-ad4e-fc2f64138bf9">Implementing a Dispose Method</a></format>. </para>
590           <block subset="none" type="note">
591             <para>Always call <see cref="M:System.Net.Mail.MailMessage.Dispose" /> before you release your last reference to the <see cref="T:System.Net.Mail.MailMessage" />.</para>
592           </block>
593         </remarks>
594         <summary>
595           <attribution license="cc4" from="Microsoft" modified="false" />
596           <para>Releases all resources used by the <see cref="T:System.Net.Mail.MailMessage" />. </para>
597         </summary>
598       </Docs>
599     </Member>
600     <Member MemberName="Dispose">
601       <MemberSignature Language="C#" Value="protected virtual void Dispose (bool disposing);" />
602       <MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance void Dispose(bool disposing) cil managed" />
603       <MemberType>Method</MemberType>
604       <AssemblyInfo>
605         <AssemblyVersion>2.0.0.0</AssemblyVersion>
606         <AssemblyVersion>4.0.0.0</AssemblyVersion>
607       </AssemblyInfo>
608       <ReturnValue>
609         <ReturnType>System.Void</ReturnType>
610       </ReturnValue>
611       <Parameters>
612         <Parameter Name="disposing" Type="System.Boolean" />
613       </Parameters>
614       <Docs>
615         <since version=".NET 2.0" />
616         <remarks>
617           <attribution license="cc4" from="Microsoft" modified="false" />
618           <para>This method is called by the public Dispose() method and the <see cref="M:System.Object.Finalize" /> method. Dispose() invokes the protected Dispose(Boolean) method with the <paramref name="disposing" /> parameter set to true. <see cref="M:System.Object.Finalize" /> invokes Dispose with <paramref name="disposing" /> set to false.</para>
619           <para>When the <paramref name="disposing" /> parameter is true, this method releases all resources held by any managed objects that this <see cref="T:System.Net.Mail.MailMessage" /> references. This method invokes the Dispose() method of each referenced object.</para>
620         </remarks>
621         <summary>
622           <attribution license="cc4" from="Microsoft" modified="false" />
623           <para>Releases the unmanaged resources used by the <see cref="T:System.Net.Mail.MailMessage" /> and optionally releases the managed resources. </para>
624         </summary>
625         <param name="disposing">
626           <attribution license="cc4" from="Microsoft" modified="false" />true to release both managed and unmanaged resources; false to release only unmanaged resources. </param>
627       </Docs>
628     </Member>
629     <Member MemberName="From">
630       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddress From { get; set; }" />
631       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddress From" />
632       <MemberType>Property</MemberType>
633       <AssemblyInfo>
634         <AssemblyVersion>2.0.0.0</AssemblyVersion>
635         <AssemblyVersion>4.0.0.0</AssemblyVersion>
636       </AssemblyInfo>
637       <ReturnValue>
638         <ReturnType>System.Net.Mail.MailAddress</ReturnType>
639       </ReturnValue>
640       <Docs>
641         <value>To be added.</value>
642         <since version=".NET 2.0" />
643         <remarks>
644           <attribution license="cc4" from="Microsoft" modified="false" />
645           <para>The from address is not validated or tied to the currently logged on user. </para>
646         </remarks>
647         <summary>
648           <attribution license="cc4" from="Microsoft" modified="false" />
649           <para>Gets or sets the from address for this e-mail message.</para>
650         </summary>
651       </Docs>
652     </Member>
653     <Member MemberName="Headers">
654       <MemberSignature Language="C#" Value="public System.Collections.Specialized.NameValueCollection Headers { get; }" />
655       <MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Specialized.NameValueCollection Headers" />
656       <MemberType>Property</MemberType>
657       <AssemblyInfo>
658         <AssemblyVersion>2.0.0.0</AssemblyVersion>
659         <AssemblyVersion>4.0.0.0</AssemblyVersion>
660       </AssemblyInfo>
661       <ReturnValue>
662         <ReturnType>System.Collections.Specialized.NameValueCollection</ReturnType>
663       </ReturnValue>
664       <Docs>
665         <value>To be added.</value>
666         <since version=".NET 2.0" />
667         <remarks>
668           <attribution license="cc4" from="Microsoft" modified="false" />
669           <para>The <see cref="P:System.Net.Mail.MailMessage.Headers" /> property allows an application to access the headers collection for the message. While this collection is read-only (a new collection can not be set), custom headers can be added to or deleted from this collection. Any custom headers added will be included when the <see cref="T:System.Net.Mail.MailMessage" /> instance is sent. Before a message is sent, only headers specifically added to this collection in the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property are included in the collection. After the <see cref="T:System.Net.Mail.MailMessage" /> instance is sent, the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property will also include headers that are set using the associated properties of the <see cref="T:System.Net.Mail.MailMessage" /> class or parameters passed when a <see cref="Overload:System.Net.Mail.MailMessage.#ctor" /> is used to initialize a <see cref="T:System.Net.Mail.MailMessage" /> object. </para>
670           <para>If some mail headers are malformed, they could cause the email message to become corrupted. So any mail header in the headers collection that can be set using a property on the <see cref="T:System.Net.Mail.MailMessage" /> class should only be set using the <see cref="T:System.Net.Mail.MailMessage" /> class property or as a parameter passed when a <see cref="Overload:System.Net.Mail.MailMessage.#ctor" /> initializes a <see cref="T:System.Net.Mail.MailMessage" /> object. The following list of mail headers should not be added using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property and any values set for these headers using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property will be discarded or overwritten when the message is sent:</para>
671           <list type="bullet">
672             <item>
673               <para>Bcc</para>
674             </item>
675             <item>
676               <para>Cc</para>
677             </item>
678             <item>
679               <para>Content-ID</para>
680             </item>
681             <item>
682               <para>Content-Location</para>
683             </item>
684             <item>
685               <para>Content-Transfer-Encoding</para>
686             </item>
687             <item>
688               <para>Content-Type</para>
689             </item>
690             <item>
691               <para>Date</para>
692             </item>
693             <item>
694               <para>From</para>
695             </item>
696             <item>
697               <para>Importance</para>
698             </item>
699             <item>
700               <para>MIME-Version</para>
701             </item>
702             <item>
703               <para>Priority</para>
704             </item>
705             <item>
706               <para>Reply-To</para>
707             </item>
708             <item>
709               <para>Sender</para>
710             </item>
711             <item>
712               <para>To</para>
713             </item>
714             <item>
715               <para>X-Priority</para>
716             </item>
717           </list>
718           <para>If the application does not specify an X-Sender header using the <see cref="P:System.Net.Mail.MailMessage.Headers" /> property, the <see cref="T:System.Net.Mail.MailMessage" /> class will create one when the message is sent. </para>
719           <para>The sender, recipient, subject, and body of an e-mail message may be specified as parameters when a <see cref="Overload:System.Net.Mail.MailMessage.#ctor" /> is used to initialize a <see cref="T:System.Net.Mail.MailMessage" /> object. These parameters may also be set or accessed using properties on the <see cref="T:System.Net.Mail.MailMessage" /> object.</para>
720           <para>The primary mail message headers and elements for the message may be set using the following properties of the <see cref="T:System.Net.Mail.MailMessage" /> class.</para>
721           <list type="table">
722             <listheader>
723               <item>
724                 <term>
725                   <para>Mail header or part</para>
726                 </term>
727                 <description>
728                   <para>Property</para>
729                 </description>
730               </item>
731             </listheader>
732             <item>
733               <term>
734                 <para>Attachments</para>
735               </term>
736               <description>
737                 <para>
738                   <see cref="P:System.Net.Mail.MailMessage.Attachments" />
739                 </para>
740               </description>
741             </item>
742             <item>
743               <term>
744                 <para>Blind carbon copies (BCC)</para>
745               </term>
746               <description>
747                 <para>
748                   <see cref="P:System.Net.Mail.MailMessage.Bcc" />
749                 </para>
750               </description>
751             </item>
752             <item>
753               <term>
754                 <para>Carbon copies (CC)</para>
755               </term>
756               <description>
757                 <para>
758                   <see cref="P:System.Net.Mail.MailMessage.CC" />
759                 </para>
760               </description>
761             </item>
762             <item>
763               <term>
764                 <para>Content-Type</para>
765               </term>
766               <description>
767                 <para>
768                   <see cref="P:System.Net.Mail.MailMessage.BodyEncoding" />
769                 </para>
770               </description>
771             </item>
772             <item>
773               <term>
774                 <para>Encoding for custom headers</para>
775               </term>
776               <description>
777                 <para>
778                   <see cref="P:System.Net.Mail.MailMessage.HeadersEncoding" />
779                 </para>
780               </description>
781             </item>
782             <item>
783               <term>
784                 <para>Message body</para>
785               </term>
786               <description>
787                 <para>
788                   <see cref="P:System.Net.Mail.MailMessage.Body" />
789                 </para>
790               </description>
791             </item>
792             <item>
793               <term>
794                 <para>Priority</para>
795               </term>
796               <description>
797                 <para>
798                   <see cref="P:System.Net.Mail.MailMessage.Priority" />
799                 </para>
800               </description>
801             </item>
802             <item>
803               <term>
804                 <para>Recipient</para>
805               </term>
806               <description>
807                 <para>
808                   <see cref="P:System.Net.Mail.MailMessage.To" />
809                 </para>
810               </description>
811             </item>
812             <item>
813               <term>
814                 <para>Reply-To</para>
815               </term>
816               <description>
817                 <para>
818                   <see cref="P:System.Net.Mail.MailMessage.ReplyToList" />
819                 </para>
820               </description>
821             </item>
822             <item>
823               <term>
824                 <para>Sender</para>
825               </term>
826               <description>
827                 <para>
828                   <see cref="P:System.Net.Mail.MailMessage.From" />
829                 </para>
830               </description>
831             </item>
832             <item>
833               <term>
834                 <para>Subject</para>
835               </term>
836               <description>
837                 <para>
838                   <see cref="P:System.Net.Mail.MailMessage.Subject" />
839                 </para>
840               </description>
841             </item>
842           </list>
843         </remarks>
844         <summary>
845           <attribution license="cc4" from="Microsoft" modified="false" />
846           <para>Gets the e-mail headers that are transmitted with this e-mail message.</para>
847         </summary>
848       </Docs>
849     </Member>
850     <Member MemberName="HeadersEncoding">
851       <MemberSignature Language="C#" Value="public System.Text.Encoding HeadersEncoding { get; set; }" />
852       <MemberSignature Language="ILAsm" Value=".property instance class System.Text.Encoding HeadersEncoding" />
853       <MemberType>Property</MemberType>
854       <AssemblyInfo>
855         <AssemblyVersion>4.0.0.0</AssemblyVersion>
856       </AssemblyInfo>
857       <ReturnValue>
858         <ReturnType>System.Text.Encoding</ReturnType>
859       </ReturnValue>
860       <Docs>
861         <value>To be added.</value>
862         <remarks>
863           <attribution license="cc4" from="Microsoft" modified="false" />
864           <para>The value of the <see cref="P:System.Net.Mail.MailMessage.HeadersEncoding" /> property defaults to <see cref="P:System.Text.Encoding.UTF8" />. </para>
865           <para>SMTP messages consist of headers and body parts. The IETF RFCs for SMTP restrict the header and body part names to be ASCII. However, the IETF RFCs allow header and body part values to contain Unicode characters. In any particular value, if non-ASCII characters exist, then the value is encoded using a combination of character encoding (UTF8 or Shift-JIS, for example) followed by byte encoding (<see cref="F:System.Net.Mime.TransferEncoding.Base64" /> or <see cref="F:System.Net.Mime.TransferEncoding.QuotedPrintable" /> for example). The result is usually that only ASCII characters are in the network transmission stream.</para>
866         </remarks>
867         <summary>
868           <attribution license="cc4" from="Microsoft" modified="false" />
869           <para>Gets or sets the encoding used for the user-defined custom headers for this e-mail message.</para>
870         </summary>
871       </Docs>
872     </Member>
873     <Member MemberName="IsBodyHtml">
874       <MemberSignature Language="C#" Value="public bool IsBodyHtml { get; set; }" />
875       <MemberSignature Language="ILAsm" Value=".property instance bool IsBodyHtml" />
876       <MemberType>Property</MemberType>
877       <AssemblyInfo>
878         <AssemblyVersion>2.0.0.0</AssemblyVersion>
879         <AssemblyVersion>4.0.0.0</AssemblyVersion>
880       </AssemblyInfo>
881       <ReturnValue>
882         <ReturnType>System.Boolean</ReturnType>
883       </ReturnValue>
884       <Docs>
885         <value>To be added.</value>
886         <remarks>To be added.</remarks>
887         <since version=".NET 2.0" />
888         <summary>
889           <attribution license="cc4" from="Microsoft" modified="false" />
890           <para>Gets or sets a value indicating whether the mail message body is in Html.</para>
891         </summary>
892       </Docs>
893     </Member>
894     <Member MemberName="Priority">
895       <MemberSignature Language="C#" Value="public System.Net.Mail.MailPriority Priority { get; set; }" />
896       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.Net.Mail.MailPriority Priority" />
897       <MemberType>Property</MemberType>
898       <AssemblyInfo>
899         <AssemblyVersion>2.0.0.0</AssemblyVersion>
900         <AssemblyVersion>4.0.0.0</AssemblyVersion>
901       </AssemblyInfo>
902       <ReturnValue>
903         <ReturnType>System.Net.Mail.MailPriority</ReturnType>
904       </ReturnValue>
905       <Docs>
906         <value>To be added.</value>
907         <remarks>To be added.</remarks>
908         <since version=".NET 2.0" />
909         <summary>
910           <attribution license="cc4" from="Microsoft" modified="false" />
911           <para>Gets or sets the priority of this e-mail message.</para>
912         </summary>
913       </Docs>
914     </Member>
915     <Member MemberName="ReplyTo">
916       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddress ReplyTo { get; set; }" />
917       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddress ReplyTo" />
918       <MemberType>Property</MemberType>
919       <AssemblyInfo>
920         <AssemblyVersion>2.0.0.0</AssemblyVersion>
921         <AssemblyVersion>4.0.0.0</AssemblyVersion>
922       </AssemblyInfo>
923       <Attributes>
924         <Attribute>
925           <AttributeName>System.Obsolete("Use ReplyToList instead")</AttributeName>
926         </Attribute>
927       </Attributes>
928       <ReturnValue>
929         <ReturnType>System.Net.Mail.MailAddress</ReturnType>
930       </ReturnValue>
931       <Docs>
932         <value>To be added.</value>
933         <since version=".NET 2.0" />
934         <remarks>
935           <attribution license="cc4" from="Microsoft" modified="false" />
936           <para>Use the <see cref="P:System.Net.Mail.MailMessage.ReplyTo" /> property to indicate an address other than the <see cref="P:System.Net.Mail.MailMessage.From" /> address to use to reply to this message.</para>
937         </remarks>
938         <summary>
939           <attribution license="cc4" from="Microsoft" modified="false" />
940           <para>Gets or sets the ReplyTo address for the mail message.</para>
941         </summary>
942       </Docs>
943     </Member>
944     <Member MemberName="ReplyToList">
945       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddressCollection ReplyToList { get; }" />
946       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddressCollection ReplyToList" />
947       <MemberType>Property</MemberType>
948       <AssemblyInfo>
949         <AssemblyVersion>4.0.0.0</AssemblyVersion>
950       </AssemblyInfo>
951       <ReturnValue>
952         <ReturnType>System.Net.Mail.MailAddressCollection</ReturnType>
953       </ReturnValue>
954       <Docs>
955         <value>To be added.</value>
956         <remarks>
957           <attribution license="cc4" from="Microsoft" modified="false" />
958           <para>Use the <see cref="P:System.Net.Mail.MailMessage.ReplyToList" /> property to indicate the list of addresses other than the <see cref="P:System.Net.Mail.MailMessage.From" /> address to use to reply to this message.</para>
959           <para>The <see cref="P:System.Net.Mail.MailMessage.ReplyToList" /> property replaces the <see cref="P:System.Net.Mail.MailMessage.ReplyTo" /> property that only allows a single address to reply to. </para>
960         </remarks>
961         <summary>
962           <attribution license="cc4" from="Microsoft" modified="false" />
963           <para>Gets or sets the list of addresses to reply to for the mail message.</para>
964         </summary>
965       </Docs>
966     </Member>
967     <Member MemberName="Sender">
968       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddress Sender { get; set; }" />
969       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddress Sender" />
970       <MemberType>Property</MemberType>
971       <AssemblyInfo>
972         <AssemblyVersion>2.0.0.0</AssemblyVersion>
973         <AssemblyVersion>4.0.0.0</AssemblyVersion>
974       </AssemblyInfo>
975       <ReturnValue>
976         <ReturnType>System.Net.Mail.MailAddress</ReturnType>
977       </ReturnValue>
978       <Docs>
979         <value>To be added.</value>
980         <since version=".NET 2.0" />
981         <remarks>
982           <attribution license="cc4" from="Microsoft" modified="false" />
983           <para>The sender's address is not validated or tied to the currently logged on user.</para>
984         </remarks>
985         <summary>
986           <attribution license="cc4" from="Microsoft" modified="false" />
987           <para>Gets or sets the sender's address for this e-mail message.</para>
988         </summary>
989       </Docs>
990     </Member>
991     <Member MemberName="Subject">
992       <MemberSignature Language="C#" Value="public string Subject { get; set; }" />
993       <MemberSignature Language="ILAsm" Value=".property instance string Subject" />
994       <MemberType>Property</MemberType>
995       <AssemblyInfo>
996         <AssemblyVersion>2.0.0.0</AssemblyVersion>
997         <AssemblyVersion>4.0.0.0</AssemblyVersion>
998       </AssemblyInfo>
999       <ReturnValue>
1000         <ReturnType>System.String</ReturnType>
1001       </ReturnValue>
1002       <Docs>
1003         <value>To be added.</value>
1004         <since version=".NET 2.0" />
1005         <remarks>
1006           <attribution license="cc4" from="Microsoft" modified="false" />
1007           <para>Specify the encoding used for the subject by using the <see cref="P:System.Net.Mail.MailMessage.SubjectEncoding" /> property. </para>
1008         </remarks>
1009         <summary>
1010           <attribution license="cc4" from="Microsoft" modified="false" />
1011           <para>Gets or sets the subject line for this e-mail message.</para>
1012         </summary>
1013       </Docs>
1014     </Member>
1015     <Member MemberName="SubjectEncoding">
1016       <MemberSignature Language="C#" Value="public System.Text.Encoding SubjectEncoding { get; set; }" />
1017       <MemberSignature Language="ILAsm" Value=".property instance class System.Text.Encoding SubjectEncoding" />
1018       <MemberType>Property</MemberType>
1019       <AssemblyInfo>
1020         <AssemblyVersion>2.0.0.0</AssemblyVersion>
1021         <AssemblyVersion>4.0.0.0</AssemblyVersion>
1022       </AssemblyInfo>
1023       <ReturnValue>
1024         <ReturnType>System.Text.Encoding</ReturnType>
1025       </ReturnValue>
1026       <Docs>
1027         <value>To be added.</value>
1028         <since version=".NET 2.0" />
1029         <remarks>
1030           <attribution license="cc4" from="Microsoft" modified="false" />
1031           <para>If a mail agent has difficulty with a <see cref="P:System.Net.Mail.MailMessage.SubjectEncoding" /> of <see cref="P:System.Text.Encoding.Unicode" />, use <see cref="P:System.Text.Encoding.UTF8" />.</para>
1032         </remarks>
1033         <summary>
1034           <attribution license="cc4" from="Microsoft" modified="false" />
1035           <para>Gets or sets the encoding used for the subject content for this e-mail message.</para>
1036         </summary>
1037       </Docs>
1038     </Member>
1039     <Member MemberName="To">
1040       <MemberSignature Language="C#" Value="public System.Net.Mail.MailAddressCollection To { get; }" />
1041       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.Mail.MailAddressCollection To" />
1042       <MemberType>Property</MemberType>
1043       <AssemblyInfo>
1044         <AssemblyVersion>2.0.0.0</AssemblyVersion>
1045         <AssemblyVersion>4.0.0.0</AssemblyVersion>
1046       </AssemblyInfo>
1047       <ReturnValue>
1048         <ReturnType>System.Net.Mail.MailAddressCollection</ReturnType>
1049       </ReturnValue>
1050       <Docs>
1051         <value>To be added.</value>
1052         <since version=".NET 2.0" />
1053         <remarks>
1054           <attribution license="cc4" from="Microsoft" modified="false" />
1055           <para>The <see cref="P:System.Net.Mail.MailMessage.To" /> property is used to designate the addresses on the To line of an e-mail message. To add a recipient to an e-mail message, create a <see cref="T:System.Net.Mail.MailAddress" /> for the recipient's address, and then add that object to the collection returned by this property.</para>
1056         </remarks>
1057         <summary>
1058           <attribution license="cc4" from="Microsoft" modified="false" />
1059           <para>Gets the address collection that contains the recipients of this e-mail message.</para>
1060         </summary>
1061       </Docs>
1062     </Member>
1063   </Members>
1064 </Type>