SslStream.CipherAlgorithm Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets a value that identifies the bulk encryption algorithm used by this SslStream.

Namespace:   System.Net.Security
Assembly:  System (in System.dll)

public virtual CipherAlgorithmType CipherAlgorithm { get; }

Exception Condition

The CipherAlgorithm property was accessed before the completion of the authentication process or the authentication process failed.

A value of Null is required for the CipherAlgorithm property when the NoEncryption enumeration value is used to construct a SslStream instance.

Windows Server 2003 and Windows XP do not support the Null value. So even if the Null value is used to construct the SslStream instance, the EncryptionPolicy property will be None. The Null value is only returned on Windows Vista and later.

The following code example displays the cryptography settings for the specified stream.

static void DisplaySecurityLevel(SslStream stream)
   Console.WriteLine("Cipher: {0} strength {1}", stream.CipherAlgorithm, stream.CipherStrength);
   Console.WriteLine("Hash: {0} strength {1}", stream.HashAlgorithm, stream.HashStrength);
   Console.WriteLine("Key exchange: {0} strength {1}", stream.KeyExchangeAlgorithm, stream.KeyExchangeStrength);
   Console.WriteLine("Protocol: {0}", stream.SslProtocol);

.NET Framework
Available since 2.0
Return to top