CryptoConfig Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Öppnar konfigurationsinformationen för kryptografi.
public ref class CryptoConfig
public class CryptoConfig
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public class CryptoConfig
[System.Runtime.InteropServices.ComVisible(true)]
public class CryptoConfig
type CryptoConfig = class
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type CryptoConfig = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type CryptoConfig = class
Public Class CryptoConfig
- Arv
-
CryptoConfig
- Attribut
Exempel
Följande kodexempel visar hur du använder medlemmar i CryptoConfig klassen.
using System;
using System.Security.Cryptography;
class Members
{
static void Main(string[] args)
{
// Create a CryptoConfig object to store configuration information.
CryptoConfig cryptoConfig = new CryptoConfig();
// Retrieve the class path for CryptoConfig.
string classDescription = cryptoConfig.ToString();
// Create a new SHA1 provider.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
SHA1CryptoServiceProvider SHA1alg =
(SHA1CryptoServiceProvider)CryptoConfig.CreateFromName("SHA1");
// Create an RSAParameters with the TestContainer key container.
CspParameters parameters = new CspParameters();
parameters.KeyContainerName = "TestContainer";
Object[] argsArray = new Object[] {parameters};
// Instantiate the RSA provider instance accessing the TestContainer
// key container.
RSA rsa = (RSA)
CryptoConfig.CreateFromName("RSA",argsArray);
// Use the MapNameToOID method to get an object identifier
// (OID) from the string name of the SHA1 algorithm.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
string sha1Oid = CryptoConfig.MapNameToOID("SHA1");
// Encode the specified object identifier.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
byte[] encodedMessage = CryptoConfig.EncodeOID(sha1Oid);
// Display the results to the console.
Console.WriteLine("** " + classDescription + " **");
Console.WriteLine("Created an RSA provider " +
"with a KeyContainerName called " + parameters.KeyContainerName +
".");
Console.WriteLine("Object identifier from the SHA1 name:" + sha1Oid);
Console.WriteLine("The object identifier encoded: " +
System.Text.Encoding.ASCII.GetString(encodedMessage));
Console.WriteLine("This sample completed successfully; " +
"press Enter to exit.");
Console.ReadLine();
}
}
//
// This sample produces the following output:
//
// ** System.Security.Cryptography.CryptoConfig **
// Created an RSA provider with a KeyContainerName called TestContainer.
// Object identifier from the SHA1 name:1.3.14.3.2.26
// The object identifier encoded: HH*((*H9
// This sample completed successfully; press Enter to exit.
Imports System.Security.Cryptography
Public Class Form1
Inherits System.Windows.Forms.Form
' Event handler for Run button.
Private Sub Button1_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
tbxOutput.Cursor = Cursors.WaitCursor
tbxOutput.Text = ""
' Create a CryptoConfig object to store configuration information.
Dim cryptoConfig As New CryptoConfig
' Retrieve the class path for CryptoConfig.
Dim classDescription As String = cryptoConfig.ToString()
' Create a new SHA1 provider.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
Dim SHA1alg As SHA1CryptoServiceProvider
SHA1alg = CType( _
cryptoConfig.CreateFromName("SHA1"), SHA1CryptoServiceProvider)
' Create an RSAParameters with the TestContainer key container.
Dim parameters As New CspParameters
parameters.KeyContainerName = "TestContainer"
Dim argsArray() = New Object() {parameters}
' Instantiate the RSA provider instance accessing the key container
' TestContainer.
Dim rsa As RSA = RSA.Create()
rsa = CType(cryptoConfig.CreateFromName( _
"RSA", argsArray), _
RSA)
' Use the MapNameToOID method to get an object identifier.
' (OID) from the string name of the SHA1 algorithm.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
Dim sha1Oid As String = cryptoConfig.MapNameToOID("SHA1")
' Encode the specified object identifier.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
Dim encodedMessage() As Byte = cryptoConfig.EncodeOID(sha1Oid)
' Display the results to the console.
tbxOutput.AppendText("** " + classDescription + " **" + vbCrLf)
tbxOutput.AppendText("Created an RSA provider with a ")
tbxOutput.AppendText("KeyContainerName called ")
tbxOutput.AppendText(parameters.KeyContainerName + "." + vbCrLf)
tbxOutput.AppendText("Object identifier from the SHA1 name:")
tbxOutput.AppendText(sha1Oid + vbCrLf)
tbxOutput.AppendText("The object identifier encoded: ")
tbxOutput.AppendText( _
System.Text.Encoding.ASCII.GetString(encodedMessage))
' Reset the cursor and conclude application.
tbxOutput.AppendText(vbCrLf + "This sample completed " + _
"successfully; press Exit to continue.")
tbxOutput.Cursor = Cursors.Default
End Sub
' Event handler for Exit button.
Private Sub Button2_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button2.Click
Application.Exit()
End Sub
#Region " Windows Form Designer generated code "
Public Sub New()
MyBase.New()
'This call is required by the Windows Form Designer.
InitializeComponent()
'Add any initialization after the InitializeComponent() call
End Sub
'Form overrides dispose to clean up the component list.
Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
If disposing Then
If Not (components Is Nothing) Then
components.Dispose()
End If
End If
MyBase.Dispose(disposing)
End Sub
'Required by the Windows Form Designer
Private components As System.ComponentModel.IContainer
'NOTE: The following procedure is required by the Windows Form Designer
'It can be modified using the Windows Form Designer.
'Do not modify it using the code editor.
Friend WithEvents Panel2 As System.Windows.Forms.Panel
Friend WithEvents Panel1 As System.Windows.Forms.Panel
Friend WithEvents Button1 As System.Windows.Forms.Button
Friend WithEvents Button2 As System.Windows.Forms.Button
Friend WithEvents tbxOutput As System.Windows.Forms.RichTextBox
<System.Diagnostics.DebuggerStepThrough()> _
Private Sub InitializeComponent()
Me.Panel2 = New System.Windows.Forms.Panel
Me.Button1 = New System.Windows.Forms.Button
Me.Button2 = New System.Windows.Forms.Button
Me.Panel1 = New System.Windows.Forms.Panel
Me.tbxOutput = New System.Windows.Forms.RichTextBox
Me.Panel2.SuspendLayout()
Me.Panel1.SuspendLayout()
Me.SuspendLayout()
'
'Panel2
'
Me.Panel2.Controls.Add(Me.Button1)
Me.Panel2.Controls.Add(Me.Button2)
Me.Panel2.Dock = System.Windows.Forms.DockStyle.Bottom
Me.Panel2.DockPadding.All = 20
Me.Panel2.Location = New System.Drawing.Point(0, 320)
Me.Panel2.Name = "Panel2"
Me.Panel2.Size = New System.Drawing.Size(616, 64)
Me.Panel2.TabIndex = 1
'
'Button1
'
Me.Button1.Dock = System.Windows.Forms.DockStyle.Right
Me.Button1.Font = New System.Drawing.Font( _
"Microsoft Sans Serif", 9.0!, _
System.Drawing.FontStyle.Regular, _
System.Drawing.GraphicsUnit.Point, _
CType(0, Byte))
Me.Button1.Location = New System.Drawing.Point(446, 20)
Me.Button1.Name = "Button1"
Me.Button1.Size = New System.Drawing.Size(75, 24)
Me.Button1.TabIndex = 2
Me.Button1.Text = "&Run"
'
'Button2
'
Me.Button2.Dock = System.Windows.Forms.DockStyle.Right
Me.Button2.Font = New System.Drawing.Font( _
"Microsoft Sans Serif", _
9.0!, _
System.Drawing.FontStyle.Regular, _
System.Drawing.GraphicsUnit.Point, _
CType(0, Byte))
Me.Button2.Location = New System.Drawing.Point(521, 20)
Me.Button2.Name = "Button2"
Me.Button2.Size = New System.Drawing.Size(75, 24)
Me.Button2.TabIndex = 3
Me.Button2.Text = "E&xit"
'
'Panel1
'
Me.Panel1.Controls.Add(Me.tbxOutput)
Me.Panel1.Dock = System.Windows.Forms.DockStyle.Fill
Me.Panel1.DockPadding.All = 20
Me.Panel1.Location = New System.Drawing.Point(0, 0)
Me.Panel1.Name = "Panel1"
Me.Panel1.Size = New System.Drawing.Size(616, 320)
Me.Panel1.TabIndex = 2
'
'tbxOutput
'
Me.tbxOutput.AccessibleDescription = _
"Displays output from application."
Me.tbxOutput.AccessibleName = "Output textbox."
Me.tbxOutput.Dock = System.Windows.Forms.DockStyle.Fill
Me.tbxOutput.Location = New System.Drawing.Point(20, 20)
Me.tbxOutput.Name = "tbxOutput"
Me.tbxOutput.Size = New System.Drawing.Size(576, 280)
Me.tbxOutput.TabIndex = 1
Me.tbxOutput.Text = "Click the Run button to run the application."
'
'Form1
'
Me.AutoScaleBaseSize = New System.Drawing.Size(6, 15)
Me.ClientSize = New System.Drawing.Size(616, 384)
Me.Controls.Add(Me.Panel1)
Me.Controls.Add(Me.Panel2)
Me.Name = "Form1"
Me.Text = "CryptoConfig"
Me.Panel2.ResumeLayout(False)
Me.Panel1.ResumeLayout(False)
Me.ResumeLayout(False)
End Sub
#End Region
End Class
'
' This sample produces the following output:
'
' ** System.Security.Cryptography.CryptoConfig **
' Created an RSA provider with a KeyContainerName called TestContainer.
' Object identifier from the SHA1 name:1.3.14.3.2.26
' The object identifier encoded: 6767gG&*(*
' This sample completed successfully; press Exit to continue.
Kommentarer
I följande tabell visas de enkla namn som identifieras av den här klassen och de standardalgoritmimplementeringar som de mappar till. Du kan också mappa andra implementeringar till dessa namn, enligt beskrivningen i Mappa algoritmnamn till kryptografiklasser.
| Enkelt namn | Algoritmimplementering |
|---|---|
| 3DES, Triple DES, TripleDES, System.Security.Cryptography.TripleDES | TripleDESCryptoServiceProvider |
| AES, System.Security.Cryptography.AesCryptoServiceProvider | AesCryptoServiceProvider |
| AesManaged, System.Security.Cryptography.AesManaged | AesManaged |
| System.Security.Cryptography.AsymmetricAlgorithm | RSACryptoServiceProvider |
| DES, System.Security.Cryptography.DES | DESCryptoServiceProvider |
| DSA, System.Security.Cryptography.DSA | DSACryptoServiceProvider |
| ECDH, ECDiffieHellman, ECDiffieHellmanCng, System.Security.Cryptography.ECDiffieHellmanCng | ECDiffieHellmanCng |
| ECDsa, ECDsaCng, System.Security.Cryptography.ECDsaCng | ECDsaCng |
| System.Security.Cryptography.HashAlgorithm | SHA1CryptoServiceProvider |
| HMAC, System.Security.Cryptography.HMAC | HMACSHA1 |
| HMACMD5, System.Security.Cryptography.HMACMD5 | HMACMD5 |
| HMACRIPEMD160, System.Security.Cryptography.HMACRIPEMD160 | HMACRIPEMD160 |
| HMACSHA1, System.Security.Cryptography.HMACSHA1 | HMACSHA1 |
| HMACSHA256, System.Security.Cryptography.HMACSHA256 | HMACSHA256 |
| HMACSHA384, System.Security.Cryptography.HMACSHA384 | HMACSHA384 |
| HMACSHA512, System.Security.Cryptography.HMACSHA512 | HMACSHA512 |
| System.Security.Cryptography.KeyedHashAlgorithm | HMACSHA1 |
| MACTripleDES, System.Security.Cryptography.MACTripleDES | MACTripleDES |
| MD5, System.Security.Cryptography.MD5 | MD5CryptoServiceProvider |
| System.Security.Cryptography.MD5Cng | MD5Cng |
| RandomNumberGenerator | RNGCryptoServiceProvider |
| RC2, System.Security.Cryptography.RC2 | RC2CryptoServiceProvider |
| Rijndael, System.Security.Cryptography.Rijndael | RijndaelManaged |
| RIPEMD160, RIPEMD-160, System.Security.Cryptography.RIPEMD160Managed | RIPEMD160Managed |
| RSA, System.Security.Cryptography.RSA | RSACryptoServiceProvider |
| SHA, SHA1, System.Security.Cryptography.SHA1 | SHA1CryptoServiceProvider |
| System.Security.Cryptography.SHA1Cng | SHA1Cng |
| SHA256, SHA-256, System.Security.Cryptography.SHA256 | SHA256Managed |
| System.Security.Cryptography.SHA256Cng | SHA256Cng |
| System.Security.Cryptography.SHA256CryptoServiceProvider | SHA256CryptoServiceProvider |
| SHA384, SHA-384, System.Security.Cryptography.SHA384 | SHA384Managed |
| System.Security.Cryptography.SHA384Cng | SHA384Cng |
| System.Security.Cryptography.SHA384CryptoServiceProvider | SHA384CryptoServiceProvider |
| SHA512, SHA-512, System.Security.Cryptography.SHA512 | SHA512Managed |
| System.Security.Cryptography.SHA512Cng | SHA512Cng |
| System.Security.Cryptography.SHA512CryptoServiceProvider | SHA512CryptoServiceProvider |
| System.Security.Cryptography.SymmetricAlgorithm | RijndaelManaged |
Konstruktorer
| Name | Description |
|---|---|
| CryptoConfig() |
Initierar en ny instans av CryptoConfig klassen. |
Egenskaper
| Name | Description |
|---|---|
| AllowOnlyFipsAlgorithms |
Anger om körningen ska framtvinga principen för att endast skapa FIPS-certifierade algoritmer (Federal Information Processing Standard). |
Metoder
| Name | Description |
|---|---|
| AddAlgorithm(Type, String[]) |
Lägger till en uppsättning namn i algoritmmappningar som ska användas för den aktuella programdomänen. |
| AddOID(String, String[]) |
Lägger till en uppsättning namn till objektidentifierarmappningar (OID) som ska användas för den aktuella programdomänen. |
| CreateFromName(String, Object[]) |
Skapar en ny instans av det angivna kryptografiska objektet med de angivna argumenten. |
| CreateFromName(String) |
Skapar en ny instans av det angivna kryptografiska objektet. |
| EncodeOID(String) |
Föråldrad.
Kodar den angivna objektidentifieraren (OID). |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MapNameToOID(String) |
Hämtar objektidentifieraren (OID) för algoritmen som motsvarar det angivna enkla namnet. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |