LEADTOOLS (Leadtools assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
RasterException Class
See Also  Members  
Leadtools Namespace : RasterException Class



The exception that is thrown when a LEADTOOLS error occurs. Supported in Silverlight, Windows Phone 7

Object Model

RasterException Class

Syntax

Visual Basic (Declaration) 
<SerializableAttribute()>
Public Class RasterException 
   Inherits LeadtoolsException
   Implements _ExceptionISerializable 
Visual Basic (Usage)Copy Code
Dim instance As RasterException
C# 
[SerializableAttribute()]
public class RasterException : LeadtoolsException, _ExceptionISerializable  
C++/CLI 
[SerializableAttribute()]
public ref class RasterException : public LeadtoolsException, _ExceptionISerializable  

Example

Visual BasicCopy Code
Public Sub Example()
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   ' Prompt the user for an image
   Dim dlg As OpenFileDialog = New OpenFileDialog()
   dlg.Filter = "All Files|*.*"
   If dlg.ShowDialog() = DialogResult.OK Then
      ' Try to load this image
      Try
         Dim img As RasterImage = codecs.Load(dlg.FileName)
         MessageBox.Show(String.Format("Image in file {0} is loaded", dlg.FileName))
         img.Dispose()
      Catch ex As RasterException
         ' See if LEADTOOLS could not recognize this image format
         If ex.Code = RasterExceptionCode.FileFormat Then
            MessageBox.Show(String.Format("File {0} does not contain an image format recognizable by LEADTOOLS", dlg.FileName))
         Else
            ' Other LEADTOOLS error (file might be corrupted, read error, etc)
            MessageBox.Show(String.Format("Could not load the file {0}.{1}Leadtools code: {2}{1}Message: {3}", dlg.FileName, Environment.NewLine, ex.Code, ex.Message))
         End If
      Catch ex As Exception
         ' Other errors
         MessageBox.Show(String.Format("Could not load the file {0}.{1}{2}", dlg.FileName, Environment.NewLine, ex.Message))
      End Try
   End If
End Sub
C#Copy Code
public void Example()
{
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;

   // Prompt the user for an image
   OpenFileDialog dlg = new OpenFileDialog();
   dlg.Filter = "All Files|*.*";
   if(dlg.ShowDialog() == DialogResult.OK)
   {
      // Try to load this image
      try
      {
         RasterImage img = codecs.Load(dlg.FileName);
         MessageBox.Show(string.Format("Image in file {0} is loaded", dlg.FileName));
         img.Dispose();
      }
      catch(RasterException ex)
      {
         // See if LEADTOOLS could not recognize this image format
         if(ex.Code == RasterExceptionCode.FileFormat)
            MessageBox.Show(string.Format("File {0} does not contain an image format recognizable by LEADTOOLS", dlg.FileName));
         else
         {
            // Other LEADTOOLS error (file might be corrupted, read error, etc)
            MessageBox.Show(string.Format("Could not load the file {0}.{1}Leadtools code: {2}{1}Message: {3}", dlg.FileName, Environment.NewLine, ex.Code, ex.Message));
         }
      }
      catch(Exception ex)
      {
         // Other errors
         MessageBox.Show(string.Format("Could not load the file {0}.{1}{2}", dlg.FileName, Environment.NewLine, ex.Message));
      }
   }
}
SilverlightCSharpCopy Code
public void Example()
{
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   // Prompt the user for an image
   OpenFileDialog dlg = new OpenFileDialog();
   dlg.Filter = "All Files|*.*";
   if(dlg.ShowDialog() == true)
   {
      // Try to load this image
      try
      {
         using (FileStream fs = dlg.File.OpenRead())
         {
            RasterImage img = codecs.Load(fs);
            MessageBox.Show(string.Format("Image in file {0} is loaded", dlg.File.FullName));
            img.Dispose();
         }
      }
      catch(RasterException ex)
      {
         // See if LEADTOOLS could not recognize this image format
         if(ex.Code == RasterExceptionCode.FileFormat)
            MessageBox.Show(string.Format("File {0} does not contain an image format recognizable by LEADTOOLS", dlg.File.FullName));
         else
         {
            // Other LEADTOOLS error (file might be corrupted, read error, etc)
            MessageBox.Show(string.Format("Could not load the file {0}.{1}Leadtools code: {2}{1}Message: {3}", dlg.File.FullName, Environment.NewLine, ex.Code, ex.Message));
         }
      }
      catch(Exception ex)
      {
         // Other errors
         MessageBox.Show(string.Format("Could not load the file {0}.{1}{2}", dlg.File.FullName, Environment.NewLine, ex.Message));
      }
   }
}
SilverlightVBCopy Code
Public Sub Example()
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True
   ' Prompt the user for an image
   Dim dlg As OpenFileDialog = New OpenFileDialog()
   dlg.Filter = "All Files|*.*"
   If dlg.ShowDialog() = True Then
      ' Try to load this image
      Try
         Using fs As FileStream = dlg.File.OpenRead()
            Dim img As RasterImage = codecs.Load(fs)
            MessageBox.Show(String.Format("Image in file {0} is loaded", dlg.File.FullName))
            img.Dispose()
         End Using
      Catch ex As RasterException
         ' See if LEADTOOLS could not recognize this image format
         If ex.Code = RasterExceptionCode.FileFormat Then
            MessageBox.Show(String.Format("File {0} does not contain an image format recognizable by LEADTOOLS", dlg.File.FullName))
         Else
            ' Other LEADTOOLS error (file might be corrupted, read error, etc)
            MessageBox.Show(String.Format("Could not load the file {0}.{1}Leadtools code: {2}{1}Message: {3}", dlg.File.FullName, Environment.NewLine, ex.Code, ex.Message))
         End If
      Catch ex As Exception
         ' Other errors
         MessageBox.Show(String.Format("Could not load the file {0}.{1}{2}", dlg.File.FullName, Environment.NewLine, ex.Message))
      End Try
   End If
End Sub

Remarks

The RasterException class defines a Code property that you can examine to determine what caused the error.

Default messages are implemented for each Code, you can get the message through the GetCodeMessage method.

Inheritance Hierarchy

System.Object
   System.Exception
      Leadtools.LeadtoolsException
         Leadtools.RasterException

Requirements

Target Platforms: Silverlight, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only), Windows Phone 7

See Also