System.Web 2.0.0.0 System.Object

The represents an item to embed in a mail message. These embedded items can be image files such as company logos. Each embedded item is specified by an identifier and a path.

To ensure that an embedded object is displayed correctly within the e-mail message file, the following conditions must be met:

The mail message is in HTML format.

The item is an image file (.jpg, .gif, .bmp, and so on).

The HTML-formatted body file specified in the property contains a reference to the image file using the following syntax:

`<img src="cid:identifier" alt="Alternate Text" />.`

If an is added to a mail message and does not fulfill all of the requirements specified previously, it will most likely be displayed as an attachment in the mail message. If an item is referenced by an identifier in the mail message but not included as an embedded item, it will appear as a broken attachment when the mail is viewed.

The stores a collection of objects for a single mail message. The is used by the property of the object to create the mail message.

Mail messages that allow embedded objects are configurable in the following Web controls by setting their properties declaratively:

The values in the and objects are not stored in view state. This protects against malicious users discovering path information for your server.

Represents an item to embed in an e-mail message constructed using the class.

- Constructor

  To get or set the identifier of the embedded item, use the property. To get or set the path to the embedded item, use the property. Both properties must be set to successfully embed the item in the mail message.

  Initializes a new instance of the class.

  2.0.0.0
- Constructor
  To be added.

  Initializes a new instance of the class, using the specified identifier name and path to populate the object.

  The name used as the identifier of the item to embed in the mail message. For more information, see .
  The path used to retrieve an item to embed in the mail message. For more information, see .
  2.0.0.0
- Property
  System.ComponentModel.DefaultValue("")
  System.ComponentModel.NotifyParentProperty(true)
  System.String To be added.

  The property specifies an identifier for an item to embed in a mail message constructed declaratively with the class. The identifier is used to map the item contained in the property to its appropriate location in the body of the file specified in the property, using the following syntax:

  `<img src="cid:identifier" alt="Alternate Text" />`

  Typically, the item is an image file. The default for the property is an empty string.

  It is a best practice for accessibility design to set the alternate text property in your mail message for any embedded images.

  Gets or sets the name that is used as the identifier of the item to be embedded in a mail message constructed with the class.

  2.0.0.0
- Property
  System.ComponentModel.NotifyParentProperty(true)
  System.ComponentModel.DefaultValue("")
  System.String To be added.

  The property specifies the path to the item you want to embed in the mail message constructed declaratively with the object. The file path in must be a path such as C:\MyServer\Banner.gif. Typically, the embedded item is an image file. If an image file is referenced by its identifier in the mail message but not included in the message, the image appears as a broken attachment when the e-mail message is viewed.

  It is a best practice for accessibility design to set the alternate text property in your mail message for any embedded images.

  Gets or sets the path that is used to retrieve an item to embed in a mail message constructed with the class.

  2.0.0.0