Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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 ref class KeySizes sealed
/** @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 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.

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

Community Additions

ADD
Show:
© 2015 Microsoft