MessageSecurityOverTcp.AlgorithmSuite Property

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.NetTcp.dll

Package:

System.ServiceModel.NetTcp v8.0.0

Source:

MessageSecurityOverTcp.cs

Specifies the algorithm suite to be used for securing messages at the SOAP level.

public:
 property System::ServiceModel::Security::SecurityAlgorithmSuite ^ AlgorithmSuite { System::ServiceModel::Security::SecurityAlgorithmSuite ^ get(); void set(System::ServiceModel::Security::SecurityAlgorithmSuite ^ value); };

public System.ServiceModel.Security.SecurityAlgorithmSuite AlgorithmSuite { get; set; }

member this.AlgorithmSuite : System.ServiceModel.Security.SecurityAlgorithmSuite with get, set

Public Property AlgorithmSuite As SecurityAlgorithmSuite

Property Value

SecurityAlgorithmSuite

A SecurityAlgorithmSuite. The default is Basic256.

Exceptions

ArgumentNullException

The value of AlgorithmSuite is null.

Examples

The following code shows how to access and set this property.

NetTcpBinding binding = new NetTcpBinding();
// Specify the mode, then the credential type.
binding.Security.Mode = SecurityMode.Message;
binding.Security.Message.ClientCredentialType =
    MessageCredentialType.UserName;
binding.Security.Message.AlgorithmSuite =
    System.ServiceModel.Security.SecurityAlgorithmSuite.Basic256;

Dim binding As New NetTcpBinding()
' Specify the mode, then the credential type.
binding.Security.Mode = SecurityMode.Message
binding.Security.Message.ClientCredentialType = MessageCredentialType.UserName
binding.Security.Message.AlgorithmSuite = System.ServiceModel.Security.SecurityAlgorithmSuite.Basic256

Remarks

You should be aware of the strengths and weaknesses of the relevant algorithms when making modifications to this setting.

If you set this property to a value other than the default and generate a configuration file using ServiceModel Metadata Utility Tool (Svcutil.exe), it is not generated correctly and you must manually edit the configuration file to set the corresponding configuration attribute to the desired value.