DataProtector Constructor
Creates a new instance of the DataProtector class by using the provided application name, primary purpose, and specific purposes.
Namespace: System.Security.Cryptography
Assembly: System.Security (in System.Security.dll)
protected DataProtector( string applicationName, string primaryPurpose, string[] specificPurposes )
Parameters
- applicationName
- Type: System.String
The name of the application.
- primaryPurpose
- Type: System.String
The primary purpose for the protected data. See Remarks for additional important information.
- specificPurposes
- Type: System.String[]
The specific purposes for the protected data. See Remarks for additional important information.
| Exception | Condition |
|---|---|
| ArgumentException | applicationName is an empty string or null. -or- primaryPurpose is an empty string or null. -or- specificPurposes contains an empty string or null. |
This constructor sets the ApplicationName, PrimaryPurpose, and SpecificPurposes properties. The combination of these three properties must uniquely identify the data you are protecting. If the data is not uniquely identified, you might inadvertently read the wrong data, or other data might be substituted for yours. Examples of primary and specific purpose pairs are “invoice” and invoice number, “gift card” and gift card number, “password” and URL string.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
