# KeySizes Classe

## Définition

Détermine le jeu des tailles de clé valides pour les algorithmes de chiffrement symétriques.Determines the set of valid key sizes for the symmetric cryptographic algorithms.

``public ref class KeySizes sealed``
``````[System.Runtime.InteropServices.ComVisible(true)]
public sealed class KeySizes``````
``type KeySizes = class``
``Public NotInheritable Class KeySizes``
Héritage
KeySizes
Attributs

## Exemples

L’exemple suivant illustre l’utilisation des membres de la classe KeySizes.The following example shows the use of members of the KeySizes class.

``````
using namespace System;
using namespace System::Security::Cryptography;

namespace CryptographySample
{
ref class KeySizesMembers
{
public:
static void Work()
{
// Initializes a new instance of the KeySizes class
// with the specified key values.
int minSize = 64;
int maxSize = 1024;
int skipSize = 64;
KeySizes^ keySizes =
gcnew KeySizes(minSize, maxSize, skipSize);

// Show the values of the keys.
ShowKeys(gcnew array<KeySizes^>(1) {keySizes},
"Custom Keys");

// Create a new symmetric algorithm and display its
// key values.
SymmetricAlgorithm^ symAlg =
SymmetricAlgorithm::Create();
ShowKeys(symAlg->LegalKeySizes, symAlg->ToString());
Console::WriteLine("rijn.blocksize:{0}",
symAlg->BlockSize);

// Create a new RSA algorithm and display its key values.
RSACryptoServiceProvider^ rsaCSP =
gcnew RSACryptoServiceProvider(384);
ShowKeys(rsaCSP->LegalKeySizes, rsaCSP->ToString());
Console::WriteLine("RSACryptoServiceProvider KeySize ="
" {0}",
rsaCSP->KeySize);

Console::WriteLine("This sample completed successfully; "
"press Enter to exit.");
Console::ReadLine();
}

private:
// Display specified KeySize properties to the console.
static void ShowKeys(array <KeySizes^>^ keySizes,
String^ objectName)
{
// Retrieve the first KeySizes in the array.
KeySizes^ firstKeySize = keySizes[0];

// Retrieve the minimum key size in bits.
int minKeySize = firstKeySize->MinSize;

// Retrieve the maximum key size in bits.
int maxKeySize = firstKeySize->MaxSize;

// Retrieve the interval between valid key size in bits.
int skipKeySize = firstKeySize->SkipSize;

Console::Write("\n KeySizes retrieved from the ");
Console::WriteLine("{0} object.", objectName);
Console::WriteLine("Minimum key size bits: {0}",
minKeySize);
Console::WriteLine("Maximum key size bits: {0}",
maxKeySize);
Console::WriteLine("Interval between key size bits: {0}",
skipKeySize);
}
};
}

using namespace CryptographySample;

int main()
{
KeySizesMembers::Work();
}
//
// This sample produces the following output:
//
// KeySizes retrieved from the Custom Keys object.
// Minimum key size bits: 64
// Maximum key size bits: 1024
// Interval between key size bits: 64
//
// KeySizes retrieved from the
//  System.Security.Cryptography.RijndaelManaged object.
// Minimum key size bits: 128
// Maximum key size bits: 256
// Interval between key size bits: 64
// rijn.blocksize:128
//
// KeySizes retrieved from the
// System.Security.Cryptography.RSACryptoServiceProvider object.
// Minimum key size bits: 384
// Maximum key size bits: 16384
// Interval between key size bits: 8
// RSACryptoServiceProvider KeySize = 384
// This sample completed successfully; press Enter to exit.
``````
``````using System;
using System.Security.Cryptography;

namespace Contoso
{
class KeySizesMembers
{
[STAThread]
static void Main(string[] args)
{
// Initializes a new instance of the KeySizes class with the
// specified key values.
int minSize = 64;
int maxSize = 1024;
int skipSize = 64;
KeySizes keySizes = new KeySizes(minSize, maxSize, skipSize);

// Show the values of the keys.
ShowKeys(new KeySizes[1]{keySizes}, "Custom Keys");

// Create a new symmetric algorithm and display its key values.
SymmetricAlgorithm rijn = SymmetricAlgorithm.Create();
ShowKeys(rijn.LegalKeySizes, rijn.ToString());
Console.WriteLine("rijn.blocksize:" + rijn.BlockSize);

// Create a new RSA algorithm and display its key values.
RSACryptoServiceProvider rsaCSP =
new RSACryptoServiceProvider(384);
ShowKeys(rsaCSP.LegalKeySizes, rsaCSP.ToString());
Console.WriteLine("RSACryptoServiceProvider KeySize = " +
rsaCSP.KeySize);

Console.WriteLine("This sample completed successfully; " +
"press Enter to exit.");
Console.ReadLine();
}

// Display specified KeySize properties to the console.
private static void ShowKeys(KeySizes[] keySizes, string objectName)
{
// Retrieve the first KeySizes in the array.
KeySizes firstKeySize = keySizes[0];

// Retrieve the minimum key size in bits.
int minKeySize = firstKeySize.MinSize;

// Retrieve the maximum key size in bits.
int maxKeySize = firstKeySize.MaxSize;

// Retrieve the interval between valid key size in bits.
int skipKeySize = firstKeySize.SkipSize;

Console.Write("\n KeySizes retrieved from the ");
Console.WriteLine(objectName + " object.");
Console.WriteLine("Minimum key size bits: " + minKeySize);
Console.WriteLine("Maximum key size bits: " + maxKeySize);
Console.WriteLine("Interval between key size bits: " +
skipKeySize);
}
}
}
//
// This sample produces the following output:
//
// KeySizes retrieved from the Custom Keys object.
// Minimum key size bits: 64
// Maximum key size bits: 1024
// Interval between key size bits: 64
//
// KeySizes retrieved from the System.Security.Cryptography.RijndaelManaged
// object.
// Minimum key size bits: 128
// Maximum key size bits: 256
// Interval between key size bits: 64
// rijn.blocksize:128
//
// KeySizes retrieved from the
// System.Security.Cryptography.RSACryptoServiceProvider object.
// Minimum key size bits: 384
// Maximum key size bits: 16384
// Interval between key size bits: 8
// RSACryptoServiceProvider KeySize = 384
// 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 = ""

' Initializes a new instance of the KeySizes class with the
' specified key values.
Dim MinSize As Integer = 64
Dim MaxSize As Integer = 1024
Dim SkipSize As Integer = 64
Dim keySizes As New KeySizes(MinSize, MaxSize, SkipSize)

' Show the values of the keys.
ShowKeys(New KeySizes(0) {keySizes}, "Custom Keys")

' Create a new symmetric algorithm and display its key values.
Dim rijn As SymmetricAlgorithm = SymmetricAlgorithm.Create()
WriteLine("rijn.blocksize:" + rijn.BlockSize.ToString())
ShowKeys(rijn.LegalKeySizes, rijn.ToString())

' Create a new RSA algorithm and display its key values.
Dim rsaCSP As New RSACryptoServiceProvider(384)
WriteLine("RSACryptoServiceProvider KeySize = " + _
rsaCSP.KeySize.ToString())
ShowKeys(rsaCSP.LegalKeySizes, rsaCSP.ToString())

' Reset the cursor and conclude application.
WriteLine("This sample completed successfully;" + _
" press Exit to continue.")
tbxOutput.Cursor = Cursors.Default
End Sub

' Display specified KeySize properties to output textbox.
Private Sub ShowKeys( _
ByVal KeySizes() As KeySizes, _
ByVal objectName As String)

' Retrieve the first KeySizes in the array.
Dim firstKeySize As KeySizes = KeySizes(0)

' Retrieve the minimum key size in bits.
Dim minKeySize As Integer = firstKeySize.MinSize

' Retrieve the maximum key size in bits.
Dim maxKeySize As Integer = firstKeySize.MaxSize

' Retrieve the interval between valid key size in bits.
Dim skipKeySize As Integer = firstKeySize.SkipSize

WriteLine("KeySizes retrieved from the " + objectName + " object.")
WriteLine("Minimum key size bits: " + minKeySize.ToString())
WriteLine("Maximum key size bits: " + maxKeySize.ToString())
WriteLine("Interval between key size bits: " + skipKeySize.ToString())
WriteLine("")
End Sub
' Display the message to the textbox with a carriage return and line feed.
Private Sub WriteLine(ByVal message As String)
tbxOutput.AppendText(message + vbCrLf)
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 = "KeySizes"
Me.Panel2.ResumeLayout(False)
Me.Panel1.ResumeLayout(False)
Me.ResumeLayout(False)

End Sub

#End Region
End Class
'
' This sample produces the following output:
'
' KeySizes retrieved from the Custom Keys object.
' Minimum key size bits: 64
' Maximum key size bits: 1024
' Interval between key size bits: 64
'
' rijn.blocksize:128
' KeySizes retrieved from the System.Security.Cryptography.RijndaelManaged
' object.
' Minimum key size bits: 128
' Maximum key size bits: 256
' Interval between key size bits: 64
'
' RSACryptoServiceProvider KeySize = 384
' KeySizes retrieved from the
' System.Security.Cryptography.RSACryptoServiceProvider object.
' Minimum key size bits: 384
' Maximum key size bits: 16384
' Interval between key size bits: 8
'
' This sample completed successfully; press Exit to continue.
``````

## Constructeurs

 Initialise une nouvelle instance de la classe KeySizes avec les valeurs de clé spécifiées.Initializes a new instance of the KeySizes class with the specified key values.

## Propriétés

 Spécifie la taille de clé maximale en bits.Specifies the maximum key size in bits. Spécifie la taille de clé minimale en bits.Specifies the minimum key size in bits. Spécifie l'intervalle entre les tailles de clé valides en bits.Specifies the interval between valid key sizes in bits.

## Méthodes

 Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object. (Hérité de Object) Sert de fonction de hachage par défaut.Serves as the default hash function. (Hérité de Object) Obtient le Type de l'instance actuelle.Gets the Type of the current instance. (Hérité de Object) Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object. (Hérité de Object) Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object. (Hérité de Object)