Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

KeySizes Class

Determines the set of valid key sizes for the symmetric cryptographic algorithms.

Namespace: System.Security.Cryptography
Assembly: mscorlib (in mscorlib.dll)

[ComVisibleAttribute(true)] 
public sealed class KeySizes
/** @attribute ComVisibleAttribute(true) */ 
public final class KeySizes
ComVisibleAttribute(true) 
public final class KeySizes

The following example shows the use of members of the KeySizes class.

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.

import System.*;
import System.Security.Cryptography.*;

class KeySizesMembers
{
    /** @attribute STAThread()
     */
    public 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[] { keySizes }, "Custom Keys");
        // Create a new symmetric algorithm and display its key values.
        SymmetricAlgorithm rijn = SymmetricAlgorithm.Create();
        ShowKeys(rijn.get_LegalKeySizes(), rijn.ToString());
        Console.WriteLine("rijn.blocksize:" + rijn.get_BlockSize());
        // Create a new RSA algorithm and display its key values.
        RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider(384);
        ShowKeys(rsaCSP.get_LegalKeySizes(), rsaCSP.ToString());
        Console.WriteLine("RSACryptoServiceProvider KeySize = " 
            + rsaCSP.get_KeySize());
        Console.WriteLine("This sample completed successfully; " 
            + "press Enter to exit.");
        Console.ReadLine();
    } //main

    // 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)keySizes.get_Item(0);
        // Retrieve the minimum key size in bits.
        int minKeySize = firstKeySize.get_MinSize();

        // Retrieve the maximum key size in bits.
        int maxKeySize = firstKeySize.get_MaxSize();

        // Retrieve the interval between valid key size in bits.
        int skipKeySize = firstKeySize.get_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);
    } //ShowKeys
} //KeySizesMembers
//
// 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.

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.