PowerTCP Mail for .NET
Insert Method
See Also  Example Send comments on this topic.
Dart.PowerTCP.Mail Namespace > MailHeader Class : Insert Method




index
The zero-based index at which value should be inserted.
value
The Object to insert.
Inserts an element into the collection at the specified index.

Syntax

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)
C# 
public override void Insert( 
   int index,
   object value
)
Managed Extensions for C++ 
public: void Insert( 
   int index,
   Object* value
) override 
C++/CLI 
public:
void Insert( 
   int index,
   Object^ value
) override 

Parameters

index
The zero-based index at which value should be inserted.
value
The Object to insert.

Exceptions

ExceptionDescription
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.

Example

The following example demonstrates the many ways a MIME message can be created.
Visual BasicCopy 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);

Remarks

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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0

See Also

Documentation Version 3.2
© 2010 Dart Communications. All Rights Reserved.