ActiveX: SLSMTP      (Filnamn: SLSMTP.OCX)

SLSMTP är en komponent med vars hjälp du kan skicka e-post till andra. Med hjälp av denna komponent kan du på ett enkelt sätt få stöd för e-post i ditt program. Komponenten tillämpar asynkron överföring vilket innebär att mejl kan postas i bakgrunden medan ditt program fortsätter med annat. Kontrollen använder protokollet SMTP vid kommunikationen med e-postservern. Komponenten kan skicka både text- och HTML-mejl. Bilder och ljud kan kodas in i ett  HTML-mejl enligt Base64-metoden.

Vissa e-postservrar kräver POP3-inloggning innan SMTP-tjänster kan utnyttjas. Om den e-postserver du vill kontakta kräver det kan du använda kontrollen SLPOP3 för att utföra detta innan du loggar in till SMTP-servern.

Not. Datatyperna nedan är angivna enligt VB 6.0 standard. I VB.NET miljö ska Integer ersättas med Short (16 bitar) och Long ersättas med Integer (32 bitar).


Egenskaper

Namn Datatyp Beskrivning
Attachment String Här specificerar du bilagor som ska skickas med mejlet. Du anger filsökvägar till de bilagor som ska bifogas. Ska du sända mer än en bilaga måste du separera filnamnen med tecknet "|".
.
BCC String Här anger du en eller flera mottagaradresser (e-postadresser) som ska erhålla en "blind" kopia av mejlet. Med "blind" kopia menas att ingen annan mottagare kan se att en kopia skickats. Används flera e-postadresser separerar du adresserna med ett komma.
.
Body String Skickar du ett vanligt textmeddelande specificerar du texten här. 
.
BodyHTML String Skickar du ett HTML-meddelande specificerar du HTML-skripten här.
.
BytesSent Long Innehåller antal bytes som har skickats iväg, dvs meddelandets storlek. Innan denna egenskap kan läsas av måste händelsen SendCompleted ha sänts.
.
Charset String Här specificerar du vilken teckentabell som ska användas till mejlet. Ett par vanligt förekommande teckentabeller är "iso-8859-1" och "windows-1252". Grundinställningen är "iso-8859-1".
.
CC String Här anger du en eller flera mottagaradresser (e-postadresser) som ska erhålla en kopia av mejlet. Används flera e-postadresser separerar du adresserna med ett komma.
.
DocumentFolder String Ifall HTML-dokumentet som ska skickas innehåller bilder och ljud vars sökvägar kan vara relativa måste du här ange sökvägen till dokumentet. Detta är nödvändigt för att de relativa sökvägarna ska tolkas rätt när bilder och ljud ska inkluderas i mejlet.
.
DocumentType Integer Här anger du vilken typ av mejl som ska skickas. 0 = ren text ("text/plain") och 1 = HTML  ("text/html"). Har denna egenskap värdet 0 hämtas body-texten från egenskapen Body. Har denna egenskap värdet 1 hämtas body-texten från egenskapen BodyHTML.
.
FromMailAddr String Här anger du avsändarens e-postadress. 
.
FromName String Här anger du avsändarens namn. 
.
IncludeObjectsInMail Boolean Om du infogat bilder eller ljud i HTML-skripten och vill att dessa ska kodas in mejlet sätter du denna egenskap till True. Då kommer objekten att kodas in enligt Base64-metoden. Denna egenskap ignoreras om DocumentType har värdet 0.
.
ListUnsubscribe String Ska e-posthuvudet innehålla ett avprenumerationsfält (List-Unsubscribe) kan du specificera dess innehåll via denna egenskap. Egenskapen kan innehålla en webbadress eller en e-postadress. Adressen ska anges mellan ett "<" och ">". Exempel:
"<http://www.mydomain.com/unsubscribe/unsubscribe.aspx?email=test@test.com>"
"<mailto:unsubscribe@mydomain.com?subject=UNSUBSCRIBE>"
Mer information om fältet List-Unsubscribe finns i detta RFC-dokument.
.
MailAddress String Här anger du den e-postadress som ska användas vid inloggning till e-postservern. 
.
MailPort Long Här anger du den port hos e-postservern som ska användas till kommunikation. Normalt används port 25. 
.
MailServer String Här anger du den e-postserver (SMTP-server) som ska användas för att skicka e-mail.
.
Password String Om den SMTP-server du tänker skicka e-post via kräver autentisering anger du ett lösenord här. Observera att egenskapen UseAuthentication måste vara satt till True för att lösenordet ska användas.
.
ReplyMailAddr String Här anger du en e-postadress dit ett svar på ditt mejl ska skickas.
.
ReplyName String Här anger du ett namn på den som ska erhålla ett svar på ditt mejl. Se även ReplyMailAddr.
.
Subject String Här skriver du in en text som ska visas i ämnesraden.
.
To String Här anger du mottagarens e-postadress.
.
ToName String Här anger du mottagarens namn. Egenskapen kan lämnas tom om namn saknas.
.
UseAuthentication Boolean Vissa SMTP-servrar kräver autentisering med användarnamn och lösenord innan ett e-mail kan skickas. Om den server du tänker använda kräver det kan du sätta denna egenskap till True samt ange användarnamn och lösenord via egenskaperna UserName och Password.
.
UseLog Boolean Sätter på/av logghantering i komponenten. Om denna egenskap har värdet True kommer en loggfil som innehåller detaljerad information om SMTP-kommunikationen mellan klient och server att skapas.
 
I Windows Vista skapas loggfilen i mappen \Users\<Användare>\AppData\Roaming\SamLogic\Log Files. I övriga Windows-versioner skapas loggfilen i Windows-katalogen. Loggfilen har alltid filnamnet SLSMTPAX.LOG.
.
UserName String Om den SMTP-server du tänker skicka e-post via kräver autentisering anger du ett användarnamn här. Observera att egenskapen UseAuthentication måste vara satt till True för att användarnamnet ska användas. 
.
XMailer String Här anger du den text som ska visas efter fältet "X-Mailer" i e-posthuvudet.
.


Händelser

Namn Beskrivning
ErrorOccured Denna händelse sänds om ett fel inträffar när ett e-mail skickas.
.
MailServerReportedError Denna händelse sänds om e-postservern rapporterar att ett fel inträffat. Parametern ReplyCode indikerar vilket typ av fel som inträffat.
.
MailTransferApproved Denna händelse sänds om inlogningen till SMTP-servern gått bra och SLSMTP har fått tillåtelse att skicka ett mail.
.
SendCompleted Denna händelse sänds efter att ett e-mail har sänts iväg och inga allvarliga fel uppstått.
.


Metoder 


Break ()

Avbryter pågående operation. Metoden kan utnyttjas om komponenten väntar på svar från e-postservern och inget sådant kommer inom en förväntad tidsrymd. Då kan denna metod anropas för att bryta vänteläget.

GetLastError () As Long

Returnerar senast inträffade felet i komponenten.

GetLastReplyCode () As Long

Returnerar senaste svarskoden från e-postservern.

GetLastReplyMsg () As String

Returnerar senaste svarsmeddelandet från e-postservern.

HaveIncludeObjects () As Boolean

Returnerar True om HTML-skripten innehåller objekt (bilder eller ljud) som kan inkluderas i meddelandet. Finns inga sådana objekt returnerar funktionen False.

SendMail () As Boolean

Sänder iväg ett e-mail. Inträffar ett fel vid initieringen returnerar funktionen False, annars returneras True. 
.


Exempel 

SLSMTP1.DocumentType = 0                    ' Vi ska skicka ut ren text
SLSMTP1.MailServer = "testserver.mail.com"  ' Ange mailserver
 SLSMTP1.MailAddress = "abc@mail.com"        ' Ange inloggnings-adress
 SLSMTP1.To = "test@test.com"                ' Ange mottagaradress
 SLSMTP1.FromMailAddr = "mail@samlogic.com"  ' Ange avsändaradress
 SLSMTP1.FromName = "SamLogic"               ' Ange avsändarnamn
 SLSMTP1.Subject = "Test"                    ' Ange ämnesrad
 SLSMTP1.Body = "Detta är en test!"          ' Ange brevtext
 SLSMTP1.SendMail                            ' Skicka iväg mailet!