Class
UnsupportedFormatException
Description
Occurs when the supplied information is in an unsupported format. This can happen in many situations, including: using a String expression that cannot be evaluated, a bad DateTime format or an inaccessible FolderItem path.
Properties
Name |
Type |
Read-Only |
Shared |
---|---|---|---|
Methods
Name |
Parameters |
Returns |
Shared |
---|---|---|---|
Property descriptions
UnsupportedFormatException.ErrorNumber
ErrorNumber As Integer
Used to contain an error number that describes the runtime error.
The following example displays a message box if, for example, you try to create more than one KeychainItem for the same application.
Var newItem As KeychainItem
If System.KeychainCount > 0 Then
newItem = New KeychainItem
// Indicate the name of the application
newItem.ServiceName = "MyApplication"
// Create a new keychain item for the application and assign the password
System.Keychain.AddPassword(newItem, "SecretPassword")
Else
System.Beep
MessageBox("You don't have a key chain.")
End If
Exception err As KeychainException
MessageBox(err.Message + ". Error Code: " + err.ErrorNumber.ToString)
UnsupportedFormatException.Message
Message As String
Used to contain descriptive text to display when the runtime exception is encountered.
The following example displays a message box if, for example, you try to create more than one KeychainItem for the same application.
Var newItem As KeyChainItem
If System.KeyChainCount > 0 Then
newItem = New KeyChainItem
// Indicate the name of the application
newItem.ServiceName = "MyApplication"
// Create a new keychain item for the application and assign the password
System.KeyChain.AddPassword(newItem, "SecretPassword")
Else
System.Beep
MessageBox("You don't have a key chain.")
End If
Exception err As KeyChainException
MessageBox(err.Message + ". Error Code: " + err.ErrorNumber.ToString)
Method descriptions
UnsupportedFormatException.Constructor
Constructor(message As String = "", errorCode As Integer = 0)
Note
Constructors are special methods called when you create an object with the New keyword and pass in the parameters above.
Used to raise your own RuntimeException with a message and optional error code.
UnsupportedFormatException.Stack
Stack As String
Returns a String array that contains a list of all of the methods in the stack from the main entrypoint to the point at which the exception was invoked.
The stack contains all the method names up and including the current method name.
This feature only works if the IncludeFunctionNames property on the App object is selected in the Shared Build Settings.
In addition to your own method calls, you will also see framework method calls, but these may not always be completely accurate due to insufficient symbols for the OS to resolve.
UnsupportedFormatException.StackFrames
StackFrames As StackFrame
Returns an array containing the stack when the exception was first raised.
Notes
You can use a string expression to set the column widths via the DesktopListBoxColumn class or the ColumnWidths property of the DesktopListBox. You can use the percent sign or the "*" symbol, as described in those sections. If you use a character that is not permitted, an UnsupportedFormatException will occur.
Sample code
The following specification causes an UnsupportedFormatException runtime error:
ListBox1.ColumnWidths = "50,50i" // not a valid width
Compatibility
All project types on all supported operating systems.
See also
RuntimeException parent class; DateTime, FolderItem, DesktopListBox, DesktopListBoxColumn, RuntimeException classes; Exception, Try statements.