MachineKey Class
Collapse the table of content
Expand the table of content

MachineKey Class

.NET Framework 4.6 and 4.5

Provides a way to encrypt or hash data (or both) by using the same algorithms and key values that are used for ASP.NET forms authentication and view state.

Namespace:   System.Web.Security
Assembly:  System.Web (in System.Web.dll)


public static class MachineKey

System_CAPS_pubmethodSystem_CAPS_staticDecode(String, MachineKeyProtection)

Obsolete.Decodes and/or validates data that has been encrypted or provided with a hash-based message authentication code (HMAC).

System_CAPS_pubmethodSystem_CAPS_staticEncode(Byte[], MachineKeyProtection)

Obsolete.Encrypts data and/or appends a hash-based message authentication code (HMAC).

System_CAPS_pubmethodSystem_CAPS_staticProtect(Byte[], String[])

Protects the specified data by encrypting or signing it.

System_CAPS_pubmethodSystem_CAPS_staticUnprotect(Byte[], String[])

Unprotects the specified data, which was protected by the Protect method.

Exception Condition

The data to encrypt, hash, decrypt, or validate does not exist

The MachineKey class provides methods that expose the hashing and encryption logic that ASP.NET provides. For information about which encryption and hashing algorithms ASP.NET uses, and the key values that it uses with them, see machineKey Element (ASP.NET Settings Schema).


The MachineKey APIs should only be used in an ASP.NET app. Behavior of the MachineKey APIs outside the context of an ASP.NET application is undefined

.NET Framework
Available since 4.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
© 2015 Microsoft