This documentation is archived and is not being maintained.

StreamSecurityUpgradeProvider Class

Implements a custom security upgrade provider, inherited from this abstract base class.

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public abstract class StreamSecurityUpgradeProvider : StreamUpgradeProvider

To add a security upgrade, you implement a class that derives from StreamSecurityUpgradeProvider.

The upgrade process has the following steps:

  1. Implement a class that derives from StreamSecurityUpgradeProvider.

  2. Register it. You do this by creating a binding element for it, and registering the provider in a custom binding.

  3. The derived class that you implement creates an instance of StreamSecurityUpgradeInitiator, which at run time initiates a request to the other end of its connection to upgrade the channel transport layer.

  4. The derived class that you implement creates an instance of StreamSecurityUpgradeAcceptor, which at run time receives the upgrade request from the preceding step, and if possible, accepts the upgrade, and returns the upgraded stream to the other side of its connection.

The security upgrade request can be one of many similar requests. If so, the requests are processed in a definite order. For more information, see StreamUpgradeProvider.

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 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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