←Select platform

RasterException Class

Summary

The exception that is thrown when a LEADTOOLS error occurs.

Syntax
C#
VB
C++
Java
[SerializableAttribute()] 
public class RasterException : LeadtoolsException 
<SerializableAttribute()> 
Public Class RasterException  
   Inherits LeadtoolsException 
   Implements System.Runtime.InteropServices._Exception, System.Runtime.Serialization.ISerializable  
public class RasterException extends LeadtoolsException  
[SerializableAttribute()] 
public ref class RasterException : public LeadtoolsException, System.Runtime.InteropServices._Exception, System.Runtime.Serialization.ISerializable   

Remarks

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

Default messages are implemented for each Code. Get the message by calling the GetCodeMessage method.

Example
C#
VB
using Leadtools; 
using Leadtools.Codecs; 
 
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)); 
      } 
   } 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
 
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#[Silverlight C# Example] 
using Leadtools; 
using Leadtools.Codecs; 
 
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)); 
      } 
   } 
} 
vb[Silverlight VB Example] 
Imports Leadtools 
Imports Leadtools.Codecs 
 
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 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly