ANSMTP SMTP COMPONENT SDK DOCUMENTATION

AltBody Property

This property specifies alternative body of current email.

Data Type: String

Remarks

In some cases, an email consists of two bodies. One is in text/html format, and another one is in text/plain format. It is called multipart/alternative format. AltBody property specifies text/plain part of an email. Why alternative? Suppose that the recipient's email client doesn't support html email, if AltBody is specified, email client will shows the AltBody.

BodyFormat property must be set to 1 (text/html) to take effect.

Usage Example:

[Visual Basic]

Private Sub SendEmail()
  Dim oSmtp As AOSMTPLib.Mail
  Set oSmtp = New AOSMTPLib.Mail

  oSmtp.ServerAddr = "mail.adminsystem.net"
  oSmtp.FromAddr = "test@adminsystem.net"
  oSmtp.AddRecipient "Support Team", "support@adminsystem.net", 0

  oSmtp.BodyFormat = 1
  oSmtp.Subject = "Test"
  oSmtp.BodyText = "<html>..<body>Hello, this is a test...."
  oSmtp.AltBody = "Hello, this is a test"
 
  If oSmtp.SendMail() = 0 Then
    MsgBox "Message delivered!"
  Else
    MsgBox oSmtp.GetLastErrDescription()
  End If
End Sub

[C#]

private void SendEmail()
{
  AOSMTPLib.MailClass oSmtp = new AOSMTPLib.MailClass();
  oSmtp.ServerAddr = "mail.adminsystem.net";
  oSmtp.FromAddr = "test@adminsystem.net";
  oSmtp.AddRecipient( "Support Team", "support@adminsystem.net", 0 );

  oSmtp.BodyFormat = 1;
  oSmtp.Subject = "Test";
  oSmtp.BodyText = "<html>..<body>Hello, this is a test....";
  oSmtp.AltBody = "Hello, this is a test";
  
  if( oSmtp.SendMail() == 0 )
    Console.WriteLine( "Message delivered!" );
  else
    Console.WriteLine( oSmtp.GetLastErrDescription());
}

[Visual C++]

#include "stdafx.h"
#include <comdef.h>
#include <iostream>
#import "C:\Program Files\AdminSystem.NET\ANSMTP\AOSMTP.dll" \ 
                                   rename_namespace("AOSMTPLib")
using namespace AOSMTPLib;
using namespace std;

void SendEmail()
{
  ::CoInitialize( NULL );
  IMailPtr oSmtp = NULL;
  oSmtp.CreateInstance("AOSMTP.Mail");
	
  oSmtp->ServerAddr = _bstr_t( "mail.adminsystem.net" );
  oSmtp->FromAddr = _bstr_t( "test@adminsystem.net" );
  oSmtp->AddRecipient( _bstr_t("Support Team"), 
                         _bstr_t("support@adminsystem.net"), 0 );

  oSmtp->BodyFormat = 1;
  oSmtp->Subject = _bstr_t("Test");
  oSmtp->BodyText = _bstr_t("<html>..<body>Hello, this is a test....");
  oSmtp->AltBody = _bstr_t("Hello, this is a test");
  
  if( oSmtp->SendMail() == 0 )
    cout << "Message delivered!" << endl;
  else
    cout << (const char*)(oSmtp->GetLastErrDescription()) << endl;
}

See Also

BodyText Property