| Visual Basic (Declaration) | |
|---|---|
Public Overrides Sub Insert( _ ByVal index As Integer, _ ByVal value As Object _ ) | |
| Visual Basic (Usage) | Copy Code |
|---|---|
Dim instance As MailHeader Dim index As Integer Dim value As Object instance.Insert(index, value) | |
Parameters
- index
- The zero-based index at which value should be inserted.
- value
- The Object to insert.
| Exception | Description |
|---|---|
| System.ArgumentOutOfRangeException | index is less than zero. -or-index is greater than Count. |
| System.NotSupportedException | The ArrayList is read-only. -or-The ArrayList has a fixed size. |
The following example demonstrates the many ways a MIME message can be created.
| Visual Basic | Copy Code |
|---|---|
' Be sure to import the namespace by putting "Imports Dart.PowerTCP.Mail" ' at the top of your class. In addition, import System.IO, as a FileStream will be used. ' Create a MessageStream object Dim msg As New MessageStream() ' Add a normal recipient msg.To.Add(New MailAddress("you@test.com")) ' Specify the sender msg.From = New MailAddress("me@test.com") ' Specify the subject msg.Subject = "Test" ' Add a MIME attachment msg.Parts.Attachments.Add(New MimeAttachmentStream("C:\files\graph.bmp")) ' Add some MIME text (Setting MessageStream.Text also does this). msg.Parts.Simple.Add(New MessagePartStream("More text here")) ' Create a complex MIME part from a stored message. msg.Parts.Complex.Add(New MessageStream(New FileStream("C:\\message.eml", FileMode.Open))) ' Create a custom MIME boundary to use. (the component will ' create a default MIME boundary to use if this isn't specified) msg.MimeBoundary = "----MyBoundary-----" ' Override automatic date setting msg.Date = "" ' Add a header line. msg.Header.Add(HeaderLabelType.Organization, "My Organization") ' Now add a custom header line. msg.Header.Add("X-My-Field: My Value") ' Specify the server Smtp1.Server = "mail.test.com" ' Send the message Smtp1.Send(msg) | |
| C# | Copy Code |
|---|---|
// Be sure to import the namespace by putting "using Dart.PowerTCP.Mail;" // at the top of your class. In addition, import System.IO, as a FileStream will be used.\ // Create a MessageStream object MessageStream msg = new MessageStream(); // Add a normal recipient msg.To.Add(new MailAddress("you@test.com")); // Specify the sender msg.From = new MailAddress("me@test.com"); // Specify the subject msg.Subject = "Test"; // Add a MIME attachment msg.Parts.Attachments.Add(new MimeAttachmentStream("C:\\files\\graph.bmp")); // Add some MIME text (MessageStream.Text also does this). msg.Parts.Simple.Add(new MessagePartStream("More text here")); // Create a complex MIME part from a stored message. msg.Parts.Complex.Add(new MessageStream(new FileStream("C:\\message.eml", FileMode.Open))); // Create a custom MIME boundary to use. (the component will // create a default MIME boundary to use if this isn't specified) msg.MimeBoundary = "----MyBoundary-----"; // Override automatic date setting msg.Date = ""; // Add a header line. msg.Header.Add(HeaderLabelType.Organization, "My Organization"); // Now add a custom header line. msg.Header.Add("X-My-Field: My Value"); // Specify the server smtp1.Server = "mail.test.com"; // Send the message smtp1.Send(msg); | |
If Count already equals Capacity, the capacity of the list is doubled by automatically reallocating the internal array before the new element is inserted.
If index is equal to Count, value is added to the end of ArrayList.
In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. If the collection is indexed, the indexes of the elements that are moved are also updated. This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hashtable.
Target Platforms: Microsoft .NET Framework 2.0