NetTcpSecurity NetTcpSecurity NetTcpSecurity NetTcpSecurity Class

Определение

Указывает типы безопасности транспортного уровня и уровня сообщений, используемые конечной точкой, настроенной с помощью NetTcpBinding.Specifies the types of transport-level and message-level security used by an endpoint configured with a NetTcpBinding.

public ref class NetTcpSecurity sealed
public sealed class NetTcpSecurity
type NetTcpSecurity = class
Public NotInheritable Class NetTcpSecurity
Наследование
NetTcpSecurityNetTcpSecurityNetTcpSecurityNetTcpSecurity

Примеры

В следующем примере кода показано, как получить объект NetTcpSecurity из привязки NetTcpBinding и распечатать различные содержащиеся в нем настройки.The following code shows how to retrieve the NetTcpSecurity object from a NetTcpBinding and prints out the various settings it contains:

using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
{
    serviceHost.Open();
    ServiceEndpointCollection endpoints = serviceHost.Description.Endpoints;
    ServiceEndpoint endpoint = endpoints.Find(typeof(ICalculator));

    NetTcpBinding binding = (NetTcpBinding) endpoint.Binding;

    NetTcpSecurity security = binding.Security;
    MessageSecurityOverTcp msTcp = security.Message;

    Console.WriteLine("Dumping NetTcpSecurity object:");
    Console.WriteLine("\tMessageSecurityOverTcp:");
    Console.WriteLine("\t\tAlgorithm Suite: {0}", msTcp.AlgorithmSuite);
    Console.WriteLine("\t\tClient Credential Type: {0}", msTcp.ClientCredentialType);

    Console.WriteLine("\tSecurity Mode: {0}", security.Mode);

    TcpTransportSecurity tsTcp = security.Transport;
    Console.WriteLine("\tTcpTransportSecurity:");
    Console.WriteLine("\t\tClient Credential Type: {0}", tsTcp.ClientCredentialType);
    Console.WriteLine("\t\tProtectionLevel: {0}", tsTcp.ProtectionLevel);

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();
}

Комментарии

Каждая из стандартных привязок предоставляет параметры для управления требованиями безопасности перемещения.Each of the standard bindings provides parameters for controlling the transfer security requirements. Эти параметры, как правило, включают режим безопасности, определяющий, используется ли безопасность уровня сообщения или уровня транспорта, а также выбор типа учетных данных клиента.These parameters typically include the security mode that specified whether message-level or transport-level security is used and the choice of client credential type. На основании предоставленного выбора параметров создается стек каналов с соответствующей безопасностью.Based on the choice of options these parameters present, a channel stack is constructed with appropriate security.

Предоставляемые системой привязки, поставляемые Windows Communication Foundation (WCF), представляют собой набор, отвечающий требованиям наиболее распространенных сценариев.The system-provided bindings supplied by Windows Communication Foundation (WCF) are a set designed to meet some of the most common scenario requirements. Каждая из этих привязок позволяет задавать требования безопасности для некоторых конкретных целевых сценариев.Each of these bindings allows the specification of security requirements for some specific targeted scenarios.

NetTcpSecurity содержит спецификации безопасности для NetTcpBinding.NetTcpSecurity provides the security specifications for NetTcpBinding. Это безопасная, надежная и оптимизированная привязка, пригодная для обмена данными между компьютерами.This is a secure, reliable, optimized binding suitable for cross-machine communication. По умолчанию она создает стек связи среды выполнения, поддерживающий протокол TCP для доставки сообщений и безопасность Windows для безопасности сообщений и проверки подлинности, WS-ReliableMessaging для надежности, а также кодирование двоичных сообщений.By default it generates a run-time communication stack that supports TCP for message delivery and Windows Security for message security and authentication, WS-ReliableMessaging for reliability, and binary message encoding.

Создание экземпляров этого класса осуществляется с помощью привязки NetTcpBinding. Доступ к классу осуществляется с помощью доступного только для чтения свойства Security.This class is instantiated by the NetTcpBinding, and can be accessed by a read-only property called Security. Поскольку это свойство доступно только для чтения, изменения в возвращаемый объект вносить нельзя.Because this property is read-only you cannot make changes to the returned object. Если необходимо управлять созданием объекта NetTcpSecurity, можно наследовать класс из привязки NetTcpBinding.If you want to control the creation of the NetTcpSecurity object, you can derive a class from NetTcpBinding.

Конструкторы

NetTcpSecurity() NetTcpSecurity() NetTcpSecurity() NetTcpSecurity()

Инициализирует новый экземпляр класса NetTcpSecurity.Initializes a new instance of the NetTcpSecurity class.

Свойства

Message Message Message Message

Получает тип требований безопасности уровня сообщений для служб, настроенных с привязкой NetTcpBinding.Gets the type of message-level security requirements for a service configured with a NetTcpBinding.

Mode Mode Mode Mode

Возвращает или задает значение, определяющее, используется ли безопасность уровня сообщений и безопасность транспортного уровня конечной точкой, настроенной с параметром NetTcpBinding.Gets or sets whether message-level security and transport-level security are used by an endpoint configured with a NetTcpBinding.

Transport Transport Transport Transport

Получает тип требований безопасности уровня сообщений для конечных точек, настроенных с привязкой NetTcpBinding.Gets the type of message-level security requirements for an endpoint configured with a NetTcpBinding.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к