ComponentSoft - Easy-to-Use and Comprehensive Libraries

Ultimate PDF - Creating a normal text

There are many ways to draw texts with the ComponentSoft UltimatePdf component. The following code example illustrates how to draw texts with each method.

1. Using DrawString

The format of the DrawString methods of the PdfGraphics are similar to the System.Drawing.Graphics.DrawString methods. It allows you to draw the specified text with the specified color, size, and font family.

The following code example illustrates this:

C#
PdfImportedDocument doc = new PdfImportedDocument(fileName); PdfPage page = doc.Pages.Add() as PdfPage; PdfGraphics g = page.Graphics; PdfFont font = new PdfStandardFont(PdfFontFamily.Helvetica, 14, PdfFontStyle.Bold); g.DrawString("My Text", font, PdfBrushes.DarkBlue, new PointF(50, 0)); doc.Save(fileName); doc.Close();

VB.NET
Dim fileName As String = "c:\test pdf.pdf" Dim doc As New PdfImportedDocument(fileName) Dim page As PdfPage = TryCast(doc.Pages.Add(), PdfPage) Dim g As PdfGraphics = page.Graphics Dim font As PdfFont = New PdfStandardFont(PdfFontFamily.Helvetica, 14, PdfFontStyle.Bold) g.DrawString("My Text", font, PdfBrushes.DarkBlue, New PointF(50, 0)) doc.Save(fileName) doc.Close()

2. Paginating the text Area

To paginate a text, simply create a new instance of the PdfTextElement class and draw it in the PDF document. To configure the layout for your spanning text, use the PdfLayoutSettings class. For more details on spanning other elements, see this topic.

C#

// Create a new PDF document. This object represents the PDF document. // This document has one page, by default. Additional pages have to be added. PdfDocument pdfDoc = new PdfDocument(); // Add a page to the document PdfPage page = pdfDoc.Pages.Add(); PdfFont font = new PdfStandardFont(PdfFontFamily.Helvetica, 14, PdfFontStyle.Bold); // Create a text element with large amount of text. PdfTextElement element = new PdfTextElement("Text Element", font); // Set the properties for the text element. element.Brush = new PdfSolidBrush(Color.Black); PdfStringFormat format = new PdfStringFormat(PdfTextAlignment.Right); // Set the string format. This can be used for setting unicode text. element.StringFormat = format; // Set the layout format properties to make the text flow through multiple pages. PdfLayoutSettings layoutFormat = new PdfLayoutSettings(); layoutFormat.Break = PdfLayoutBreakType.FitPage; layoutFormat.Layout = PdfLayoutType.Paginate; // Set the bounds. RectangleF bounds = new RectangleF(PointF.Empty, page.Graphics.ClientSize); // Draw the text element. element.Draw(page, bounds, layoutFormat); // Save the PDF document to disk. pdfDoc.Save("Test.pdf"); // Use the following code to stream the document to the browser. // pdfDoc.Save("Test.pdf", Response, HttpResponseType.OpenInsideBrowser); // Response is an HttpResponse object. // Close the document. pdfDoc.Close();

VB.NET

' Create a new PDF document. This object represents the PDF document. ' This document has one page, by default. Additional pages have to be added. Dim pdfDoc As New PdfDocument() ' Add a page to the document Dim page As PdfPage = pdfDoc.Pages.Add() Dim font As PdfFont = New PdfStandardFont(PdfFontFamily.Helvetica, 14, PdfFontStyle.Bold) ' Create a text element with large amount of text. Dim element As New PdfTextElement("Text Element", font) ' Set the properties for the text element. element.Brush = New PdfSolidBrush(Color.Black) Dim format As New PdfStringFormat(PdfTextAlignment.Right) ' Set the string format. This can be used for setting unicode text. element.StringFormat = format ' Set the layout format properties to make the text flow through multiple pages. Dim layoutFormat As New PdfLayoutSettings() layoutFormat.Break = PdfLayoutBreakType.FitPage layoutFormat.Layout = PdfLayoutType.Paginate ' Set the bounds. Dim bounds As New RectangleF(PointF.Empty, page.Graphics.ClientSize) ' Draw the text element. element.Draw(page, bounds, layoutFormat) ' Save the PDF document to disk. pdfDoc.Save("Test.pdf") ' Use the following code to stream the document to the browser. ' pdfDoc.Save("Test.pdf", Response, HttpResponseType.OpenInsideBrowser); // Response is an HttpResponse object. ' Close the document. pdfDoc.Close()

3. String Formatting

For dedicated presentation of text in a PDF document, use a PdfStringFormat object. PdfStringFormat class provides support for the following features:

Formatting a text in a PDF document is very easy with the Ultimate Pdf component. By using the PdfStringFormat class, you can quickly set character spacing, word spacing, and line spacing. In addition, it also lets you format your text area with Center, Left, Right and Justify text alignments. You can also set Right-To-Left text align for languages such as Arabic, Hebrew, Urdu, and so on.

4. RTF Support

The UltimatePdf component fully supports converting RTF document to PDF document. A RTF text can either be converted to metafile image or raster image. To convert a RTF text, simply use the FromRtf methods of the PdfImage class in the UltimatePdf library.

Creating an e-mail message containing embedded resources

The code snippet below shows you how to create an e-mail message and add an image from local disk as a LinkedResource object with ComponentSoft Mail library:

C#

// Create a new instance of the MailMessage class. MailMessage msg = new MailMessage(); // Add from address. msg.From.Add("fromemail@domain.com"); // Add recipient. msg.To.Add("fromemail@domain.com"); // Set subject. msg.Subject = "MHT message"; // ImageTypeName's src is linked to an embedded image. msg.BodyHtml = "Below is an attached image:<br><img src='cid:myimage'>"; // Create a LinkedResource object. LinkedResource lr = new LinkedResource("c:\\myfolder\\myimage.jpg", ImageTypeNames.Jpeg); lr.ContentIdentifier = "myimage"; msg.LinkedResources.Add(lr); // Connect, login and send the message here. // the following code demonstrates how to do that: //  SmtpClient client = new SmtpClient(); //  client.Connect("servername"); //  client.Authenticate("username", "password"); //  client.Send(msg); //  client.Disconnect(); // ...

VB.NET

' Create a new instance of the MailMessage class. Dim msg As New MailMessage() ' Add from address. msg.From.Add("fromemail@domain.com") ' Add recipient. msg.To.Add("fromemail@domain.com") ' Set subject. msg.Subject = "MHT message" ' ImageTypeName's src is linked to an embedded image. msg.BodyHtml = "Below is an attached image:<br><img src='cid:myimage'>" ' Create a LinkedResource object. Dim lr As New LinkedResource("c:\myfolder\myimage.jpg", ImageTypeNames.Jpeg) lr.ContentIdentifier = "myimage" msg.LinkedResources.Add(lr) ' Connect, login and send the message here. ' the following code demonstrates how to do that: ' SmtpClient client = new SmtpClient(); ' client.Connect("servername"); ' client.Authenticate("username", "password"); ' client.Send(msg); ' client.Disconnect(); ' ...

Loading and existing message and validating signature with Ultimate Mail

Loading an existing message:

With UltimateMail component, you can quickly create a new message from many sources such as from local disk file or data stream. The following sample illustrates how to create load an existing message (.EML).

C#
// Create a new instance of the MailMessage class. MailMessage msg = new MailMessage("c:\\temp\\my message.eml"); // ... // Add recipient to it. msg.To.Add("someone@somedomain.com");

VB.NET
' Create a new instance of the MailMessage class. Dim msg As New MailMessage("c:\temp\my message.eml") ' ... ' Add recipient to it. msg.To.Add("someone@somedomain.com")

Loading an existing message:

The signed mail message should be validated to make sure the message was composed by the signer. To accomplish this, you can call the Validate method of the Smime class. To ensure the message is signed or not, you can use the IsSigned property of the MailMessage class in the ComponentSoft.Net.Mail namespace.

The following simple example shows you how to check a message to see whether it's signed or not, if it's signed we will validate the message's certificate:

C#

// Create a new instance of the MailMessage class. MailMessage msg = new MailMessage(); // Load the message from a file. msg.Load("testmessage.eml"); // Check to see whether the message is signed or not. if (msg.IsSigned) {    MailSignatureValidationResult validationResult = Smime.Validate(msg);    if (validationResult.Valid)        Console.WriteLine("The signature is valid.");    else        Console.WriteLine("The signature is invalid.");    Smime.Decrypt(msg); } else    Console.WriteLine("The message is not signed.");

VB.NET

' Create a new instance of the MailMessage class. Dim msg As New MailMessage() ' Load the message from a file. msg.Load("testmessage.eml") ' Check to see whether the message is signed or not. If msg.IsSigned Then     Dim validationResult As MailSignatureValidationResult = Smime.Validate(msg)     If validationResult.Valid Then         Console.WriteLine("The signature is valid.")     Else         Console.WriteLine("The signature is invalid.")     End If     Smime.Decrypt(msg) Else     Console.WriteLine("The message is not signed.") End If

 

 

How to send mail message to multiple recipients

This topic illustrates how to compose an email message and send it to multiple recipients with a single line of code. UltimateMail makes sending to multiple recipients easy to manage, by representing these types as collections of the MailMessage object.

C#

const string serverName = "myserver";
const string user = "name@domain.com";
const string password = "mytestpassword";
const int port = 465;
const SecurityMode securityMode = SecurityMode.Implicit;
SmtpClient client = new SmtpClient();
try
{
   MailMessage mmMessage = new MailMessage();
   mmMessage.From.Add("from@thedomain.com");
   mmMessage.To.Add("name@domain.com");
   mmMessage.To.Add("someone@domain.com");
   mmMessage.Cc.Add("someone2@domain.com");
   mmMessage.Bcc.Add("someone3@domain.com");
   mmMessage.Subject = "Test Subject";
   mmMessage.BodyText = "Test Content";
   Console.WriteLine("Connecting SMTP server: {0}:{1}...", serverName, port);
   // Connect to the server.
   client.Connect(serverName, port, securityMode);
   // Login to the server.
   Console.WriteLine("Logging in as {0}...", user);
   client.Authenticate(user, password);
   Console.WriteLine("Sending mail message...");
   client.Send(mmMessage);
   Console.WriteLine("Message sent...");
   // Disconnect.
   Console.WriteLine("Disconnecting...");
   client.Disconnect();
}
catch (SmtpException smtpExc)
{
   MessageBox.Show(string.Format("An SMTP error occurred: {0}, ErrorStatus: {1}", smtpExc.Message, smtpExc.Status));
}
catch (Exception exc)
{
   MessageBox.Show(string.Format("An error occurred: {0}", exc.Message));
}

VB.NET

Const serverName As String = "myserver"
Const user As String = "name@domain.com"
Const password As String = "mytestpassword"
Const port As Integer = 465
Const securityMode As SecurityMode = securityMode.Implicit
Dim client As New SmtpClient()
Try
    Dim mmMessage As New MailMessage()
    mmMessage.From.Add("from@thedomain.com")
    mmMessage.To.Add("name@domain.com")
    mmMessage.To.Add("someone@domain.com")
    mmMessage.Cc.Add("someone2@domain.com")
    mmMessage.Bcc.Add("someone3@domain.com")
    mmMessage.Subject = "Test Subject"
    mmMessage.BodyText = "Test Content"
    Console.WriteLine("Connecting SMTP server: {0}:{1}...", serverName, port)
    ' Connect to the server.
    client.Connect(serverName, port, securityMode)
    ' Login to the server.
    Console.WriteLine("Logging in as {0}...", user)
    client.Authenticate(user, password)
    Console.WriteLine("Sending mail message...")
    client.Send(mmMessage)
    Console.WriteLine("Message sent...")
    ' Disconnect.
    Console.WriteLine("Disconnecting...")
    client.Disconnect()
Catch smtpExc As SmtpException
    MessageBox.Show(String.Format("An SMTP error occurred: {0}, ErrorStatus: {1}", smtpExc.Message, smtpExc.Status))
Catch exc As Exception
    MessageBox.Show(String.Format("An error occurred: {0}", exc.Message))
End Try

Posted via web from ComponentSoft.net Ultimate SMTP Component's Blog

How to Get Mailbox Information

This tutorial illustrates how to obtain Mailbox information with a few lines of code in UltimateIMAP Component. The simplest way to obtain information about a specified mailbox is using the GetMailboxInfo method. You only need to pass the mailbox name to the method. It returns a Mailbox object containing information about the mailbox you have requested as shown in the following steps:

1. Create a new instance of the ImapClient class and call the Connect methods. The code looks similar to the following:
2. C#
   // Create a new instance of the ImapClient class.
   ImapClient client = new ImapClient();
   // Connect to the server.
   client.Connect("myserver");
   // Or you can specify the IMAP port with
   // client.Connect("myserver", 143);
   // Login to the server.
   client.Authenticate("user", "password");
   // Get information about the INBOX mailbox.
   Mailbox m = client.GetMailboxInfo("INBOX");
   Console.WriteLine("The number of recent messages: " + m.RecentMessages);
   Console.WriteLine("The number of new unseen messages messages: " + m.NewUnseenMessages);
   // Close the connection.
   client.Disconnect();
   VB.NET
   ' Create a new instance of the ImapClient class.
   Dim client As New ImapClient()
   ' Connect to the server.
   client.Connect("myserver")
   ' Or you can specify the IMAP port with
   ' client.Connect("myserver", 143);
   ' Login to the server.
   client.Authenticate("user", "password")
   ' Get information about the INBOX mailbox.
   Dim m As Mailbox = client.GetMailboxInfo("INBOX")
   Console.WriteLine("The number of recent messages: " & m.RecentMessages)
   Console.WriteLine("The number of new unseen messages messages: " & m.NewUnseenMessages)
   ' Close the connection.
   client.Disconnect()
   

Posted via web from ComponentSoft.net Ultimate IMAP Component's Blog

How to setup a Google SSO web application using Ultimate SAML component

This tutorial illustrates how to configure your Google account to work with your IdP Web Application using ComponentSoft Ultimate SAML.

Configuring the Saml2GoogleSSO Identify Provider Web Application

You only need to change the list of user credentials in web.config file. The user name specified in web.config file must match with an account name in Google Apps.

Configuring Google Apps to work with your Identity Provider

To enable and configure single sign-on in Google Apps, you can follow the following steps:

1. Login to Google Apps.
2. Select "Advanced tools".
   
3. Then select "Set up single sign-on (SSO)".
   
4. Upload certificate, such as the SP_X509Certificate_ForGoogleSP.cer in the Idp web application.
5. Set Sign-in page URL, Sign-out page URL, and Change password URL. For example, when you deploy the test application on your server with domain name mydomain.com, the following URLs should be specified:
   1. Sign-in page URL: http://www.mydomain.com/service.aspx
   2. Sign-out page URL: http://www.mydomain.com/UserLogout.aspx
   3. Change password URL: http://www.mydomain.com/changepassword.aspx
   
6. Add a user in Google Apps that is known to the IdP web application.

Testing the Identify Provider Web Application

The identity provider web application, in conjunction with Google Apps, demonstrates SP initiated single sign-on. To test the application, follow the steps below:

1. Browse to a Google App (e.g Google Calendar at http://www.google.com/calendar/hosted/mydomain.com).
2. You should then be redirected to the Idp's Login page
3. Login with the credentials configured in Google App. You need to make sure that the user name specified in web.config file matches with the user name used to login to Google App.
4. You should then be redirected and signed into the Google App.
   
5. If you wish to change the account password, click on Settings, and then Google Account Settings->Change password
   
6. To Logout from the Google App, click on the Sign out link on the Google App page.
7. You should then be redirected to the Idp Sample Web Application logout page.

Posted via web from ComponentSoft.net Ultimate SAML Component's Blog

How to add files and folders to an archive

This topic demonstrates how to add files and folders to an archive. To add files and folders to an archive, you need to perform the following steps:

1. Specify a folder path whose files will be added to the archive.
2. Retrieve a reference to a new or existing archive file using the Zip class.
3. Call AddFile or AddFiles methods to copy or move existing files to the archive.

See the following example more more details:

C#

// Create a new instance. Zip zip = new Zip(); // Create a new zip file. zip.Create("test.zip"); // Set password zip.EncryptionAlgorithm = EncryptionAlgorithm.PkzipClassic; zip.Password = "password"; // Add all files and subdirectories from 'c:\test' to the archive. zip.AddFiles(@"c:\test"); // Add all files and subdirectories from 'c:\my folder' to the archive. zip.AddFiles(@"c:\my folder", ""); // Add all files and subdirectories from 'c:\my folder' to '22' folder within the archive. zip.AddFiles(@"c:\my folder2", "22"); // Add all .dat files from 'c:\my folder' to '22' folder within the archive. zip.AddFiles(@"c:\my folder2", "22", "*.dat"); // Or simply use this to add all .dat files from 'c:\my folder' to '22' folder within the archive. zip.AddFiles(@"c:\my folder2\*.dat", "22"); // Add *.dat and *.exe files from 'c:\my folder' to '22' folder within the archive. zip.AddFiles(@"c:\my folder2\*.dat;*.exe", "22"); // Close the zip file. zip.Close();

VB.NET

' Create a new instance. Dim zip As New Zip() ' Create a new zip file. zip.Create("test.zip") ' Set password zip.EncryptionAlgorithm = EncryptionAlgorithm.PkzipClassic zip.Password = "password" ' Add all files and subdirectories from 'c:\test' to the archive. zip.AddFiles("c:\test") ' Add all files and subdirectories from 'c:\my folder' to the archive. zip.AddFiles("c:\my folder", "") ' Add all files and subdirectories from 'c:\my folder' to '22' folder within the archive. zip.AddFiles("c:\my folder2", "22") ' Add all .dat files from 'c:\my folder' to '22' folder within the archive. zip.AddFiles("c:\my folder2", "22", "*.dat") ' Or simply use this to add all .dat files from 'c:\my folder' to '22' folder within the archive. zip.AddFiles("c:\my folder2\*.dat", "22") ' Add *.dat and *.exe files from 'c:\my folder' to '22' folder within the archive. zip.AddFiles("c:\my folder2\*.dat;*.exe", "22") ' Close the zip file. zip.Close()

Posted via web from ComponentSoft.net Ultimate ZIP Component's Blog

How to use GMAIL Account to send emails

Explicit connection and Implicit connection are two secure methods to connect to a secure SMTP/SMTP/POP3 server. This topic will go in detail the Implicit connection.

Originally, a separate port was assigned to the SSL version of all these three protocols. These were 465 for SMTP/SSL, 993 for SMTP/SSL and 995 for POP3/SSL. Upon connection to this port, an SSL negotiation starts immediately and the control connection is secured. All data connections are also secured implicitly in the same way. This is similar to the approach used by HTTPS.

The code snippet below shows how to connect to the Gmail SMTP server securely using Implicit security mode and send an email:

C#

// Create a new instance of the SmtpClient class. SmtpClient client = new SmtpClient(); // Connect to the server. client.Connect("myserver", 465, SecurityMode.Implicit); // Login to the server. client.Authenticate("user", "password"); // Create a new mail message. MailMessage msg = new MailMessage(); msg.Subject = "Test Subject"; msg.BodyText = "Content"; msg.From = "from@mydomain.com"; msg.To = "to@somedomain.com"; // And send it. client.Send(msg); // Close the connection. client.Disconnect();

VB.NET

' Create a new instance of the SmtpClient class. Dim client As New SmtpClient() ' Connect to the server. client.Connect("myserver", 465, SecurityMode.Implicit) ' Login to the server. client.Authenticate("user", "password") ' Create a new mail message. Dim msg As New MailMessage() msg.Subject = "Test Subject" msg.BodyText = "Content" msg.From = "from@mydomain.com" msg.To = "to@somedomain.com" ' And send it. client.Send(msg) ' Close the connection. client.Disconnect()

Posted via web from ComponentSoft.net Ultimate SMTP Component's Blog

How to Downloading Mail Message Synchronously

Downloading mail messages from a IMAP server in ComponentSoft UltimateMail component is so simple, you just call the DownloadMailMessage method and you retrieve an instance of the MailMessage class. You can now read, modify, save to disk the message. If you just need to download the message to disk or write it into a stream, just call the convenient DownloadMessage method instead.

The example below shows you how to get a list of messages from a IMAP server and download and save all messages to disk:

C#

// Select 'INBOX' mailbox client.Select("INBOX"); // Get the message list. Console.WriteLine("Getting message list..."); ImapMessageCollection list = client.ListMessages(EnvelopeParts.UniqueId | EnvelopeParts.Size); // Get messages. for (int i = 0; i < list.Count; i++) { ImapMessage imapMessage = list[i]; // Download the message to an instance of the MailMessage class. MailMessage msg = client.DownloadMailMessage(imapMessage.UniqueId); // Display some information about it. Console.WriteLine("Size: " + imapMessage.Size); Console.WriteLine("Number of attachments: " + msg.Attachments.Count); Console.WriteLine("Number of header name value pairs: " + msg.Headers.Count); }

VB.NET

' Select 'INBOX' mailbox client.Select("INBOX") ' Get the message list. Console.WriteLine("Getting message list...") Dim list As ImapMessageCollection = client.ListMessages(EnvelopeParts.UniqueId Or EnvelopeParts.Size) ' Get messages. For i As Integer = 0 To list.Count - 1 Dim imapMessage As ImapMessage = list(i) ' Download the message to an instance of the MailMessage class. Dim msg As MailMessage = client.DownloadMailMessage(imapMessage.UniqueId) ' Display some information about it. Console.WriteLine("Size: " & imapMessage.Size) Console.WriteLine("Number of attachments: " & msg.Attachments.Count) Console.WriteLine("Number of header name value pairs: " & msg.Headers.Count) Next i

Posted via web from ComponentSoft.net Ultimate IMAP Component's Blog

How to upload selected files and directories with UltimateSftp

Use the UploadFiles method to easily upload selected files and directories from the local disk to the SFTP server. You just need to provide local path, remote path, files and directories to upload and transfer options, ComponentSoft Ultimate SFTP component will do the rest of hard work for you.

The following steps show you how to use the UploadFiles method to upload multiple files to the remote server.

C#

// Create a new instance. Sftp client = new Sftp(); // Connect to the SFTP server. client.Connect("localhost"); // Authenticate. client.Authenticate("test", "test"); // ... // List of files and directories to upload. string[] files = new string[] { "myfile", "my dir", @"c:\my folder\my dir2" }; // Upload selected files and subdirectories in local folder 'c:\my folder' to the remote dir '/temp'. client.UploadFiles(@"c:\my folder", files, "/temp", new TransferOptions()); // ... // Disconnect. client.Disconnect();

VB.NET

' Create a new instance. Dim client As New Sftp() ' Connect to the SFTP server. client.Connect("localhost") ' Authenticate. client.Authenticate("test", "test") ' ... ' List of files and directories to upload. Dim files() As String = {"myfile", "my dir", "c:\my folder\my dir2"} ' Upload selected files and subdirectories in local folder 'c:\my folder' to the remote dir '/temp'. client.UploadFiles("c:\my folder", files, "/temp", New TransferOptions()) ' ... ' Disconnect. client.Disconnect()

Posted via web from ComponentSoft.net Ultimate SFTP Component's Blog