This documentation is archived and is not being maintained.

AsymmetricAlgorithm.KeySize Property

Gets or sets the size, in bits, of the key modulus used by the asymmetric algorithm.

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

Public Overridable Property KeySize As Integer
Dim instance As AsymmetricAlgorithm
Dim value As Integer

value = instance.KeySize

instance.KeySize = value
/** @property */
public int get_KeySize ()

/** @property */
public void set_KeySize (int value)

public function get KeySize () : int

public function set KeySize (value : int)

Not applicable.

Property Value

The size, in bits, of the key modulus used by the asymmetric algorithm.

Exception typeCondition


The key modulus size is invalid.

The valid key sizes are specified by the particular implementation of the asymmetric algorithm and are listed in the LegalKeySizes property.

The following code example demonstrates how to override the KeySize property to verify that it falls within the range identified in the local keySizes member variable. This code example is part of a larger example provided for the AsymmetricAlgorithm class.

Public Overrides Property KeySize() As Integer
        Return KeySizeValue
    End Get
    Set(ByVal Value As Integer)
        For i As Int16 = 0 To keySizes.Length - 1 Step i
            If (keySizes(i).SkipSize.Equals(0)) Then
                If (keySizes(i).MinSize.Equals(Value)) Then
                    KeySizeValue = Value
                End If
                For j As Integer = keySizes(i).MinSize _
                    To keySizes(i).MaxSize _
                    Step keySizes(i).SkipSize
                    If (j.Equals(Value)) Then
                        KeySizeValue = Value
                    End If
            End If
        ' If the key does not fall within the range identified 
        ' in the keySizes member variable, throw an exception.
        Throw New CryptographicException("Invalid key size.")
    End Set
End Property

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0