This documentation is archived and is not being maintained.

ExchangeAlgorithmType Enumeration

Specifies the algorithm used to create keys shared by the client and server.

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

public enum ExchangeAlgorithmType

Member nameDescription
NoneNo key exchange algorithm is used.
RsaSignThe RSA public-key signature algorithm.
RsaKeyXThe RSA public-key exchange algorithm.
DiffieHellmanThe Diffie Hellman ephemeral key exchange algorithm.

This enumeration specifies valid values for the SslStream.KeyExchangeAlgorithm property.

The following example displays the properties of an SslStream.

static void AuthenticateCallback(IAsyncResult ar)
{
    SslStream stream = (SslStream) ar.AsyncState;
    try 
    {
        stream.EndAuthenticateAsClient(ar);
        Console.WriteLine("Authentication succeeded.");
        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);
        // Encode a test message into a byte array. 
        // Signal the end of the message using the "<EOF>".
        byte[] message = Encoding.UTF8.GetBytes("Hello from the client.<EOF>");
        // Asynchronously send a message to the server.
        stream.BeginWrite(message, 0, message.Length, 
            new AsyncCallback(WriteCallback),
            stream);
    }
    catch (Exception authenticationException)
    {
        e = authenticationException;
        complete = true;
        return;
    }
}
static void AuthenticateCallback(IAsyncResult* ar)
{
    SslStream* stream = dynamic_cast<SslStream*> (ar->AsyncState);
    try 
    {
        stream->EndClientAuthenticate(ar);
        Console::WriteLine(S"Authentication succeeded.");
        Console::WriteLine(S"Cipher: {0} strength {1}", __box(stream->CipherAlgorithm), __box(stream->CipherStrength));
        Console::WriteLine(S"Hash: {0} strength {1}", __box(stream->HashAlgorithm), __box(stream->HashStrength));
        Console::WriteLine(S"Key exchange: {0} strength {1}", __box(stream->KeyExchangeAlgorithm), __box(stream->KeyExchangeStrength));
        Console::WriteLine(S"Protocol: {0}", __box(stream->SslProtocol));
        // Encode a test message into a byte array.
        // Signal the end of the message using the "<EOF>".
        Byte message[] = Encoding::UTF8->GetBytes(S"Hello from the client.<EOF>");
        // Asynchronously send a message to the server.
        stream->BeginWrite(message, 0, message->Length, 
            new AsyncCallback(WriteCallback),
            stream);
    }
    catch (Exception* authenticationException)
    {
        e = authenticationException;
        complete = true;
        return;
    }
}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: