DataMisalignedException Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
The exception that is thrown when a unit of data is read from or written to an address that is not a multiple of the data size. This class cannot be inherited.
Inheritance Hierarchy
System..::.Object
System..::.Exception
System..::.SystemException
System..::.DataMisalignedException
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
Public NotInheritable Class DataMisalignedException _
Inherits SystemException
public sealed class DataMisalignedException : SystemException
The DataMisalignedException type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
DataMisalignedException()()() | Initializes a new instance of the DataMisalignedException class. |
|
DataMisalignedException(String) | Initializes a new instance of the DataMisalignedException class using the specified error message. |
|
DataMisalignedException(String, Exception) | Initializes a new instance of the DataMisalignedException class using the specified error message and underlying exception. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Data | Gets a collection of key/value pairs that provide additional user-defined information about the exception. (Inherited from Exception.) |
|
HelpLink | Gets or sets a link to the help file associated with this exception. (Inherited from Exception.) |
|
HResult | Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Inherited from Exception.) |
|
InnerException | Gets the Exception instance that caused the current exception. (Inherited from Exception.) |
|
Message | Gets a message that describes the current exception. (Inherited from Exception.) |
|
Source | Gets or sets the name of the application or the object that causes the error. (Inherited from Exception.) |
|
StackTrace | Gets a string representation of the frames on the call stack at the time the current exception was thrown. (Inherited from Exception.) |
Top
Methods
| Name | Description | |
|---|---|---|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
.gif "Protected method") |
Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
|
GetBaseException | When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Inherited from Exception.) |
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
GetType | Gets the runtime type of the current instance. (Inherited from Exception.) |
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
ToString | Creates and returns a string representation of the current exception. (Inherited from Exception.) |
Top
Remarks
Note
This class supports the .NET Framework for Windows Phone library and is not intended to be used by Windows Phone app code.
Some microprocessors, such as 64-bit processors, can issue hardware exceptions when data is read or written to a misaligned address (that is, when an address is not a multiple of the size of the data being accessed). DataMisalignedException is typically thrown when 16-bit, 32-bit, or 64-bit data is read from or written to an address that is not a multiple of two, four, or eight bytes.
The DataMisalignedException exposes the underlying hardware exception, which allows you to respond in an appropriate manner. For example, a routine in your application attempts to copy a sequence of bytes from one location to another in 64-bit units. However, the write operation starts at a misaligned address, which causes the common language runtime to throw a DataMisalignedException. Your routine responds to the exception by copying the data one byte at a time.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.