NetTcpSecurity Klas

Definitie

public ref class NetTcpSecurity sealed

public sealed class NetTcpSecurity

type NetTcpSecurity = class

Public NotInheritable Class NetTcpSecurity

Overname

Object

NetTcpSecurity

Voorbeelden

De volgende code laat zien hoe u het NetTcpSecurity object ophaalt uit een NetTcpBinding object en de verschillende instellingen weergeeft die het bevat:

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();
}

Opmerkingen

Elk van de standaardbindingen biedt parameters voor het beheren van de beveiligingsvereisten voor overdracht. Deze parameters bevatten doorgaans de beveiligingsmodus die is opgegeven of beveiliging op berichtniveau of transportniveau wordt gebruikt en de keuze van het clientreferentietype. Op basis van de keuze aan opties die deze parameters aanwezig zijn, wordt een kanaalstack samengesteld met de juiste beveiliging.

De door het systeem geleverde bindingen die door WCF (Windows Communication Foundation) worden geleverd, zijn een set die is ontworpen om te voldoen aan een aantal van de meest voorkomende scenariovereisten. Elk van deze bindingen biedt de specificatie van beveiligingsvereisten voor bepaalde specifieke gerichte scenario's.

NetTcpSecurity voorziet in de beveiligingsspecificaties voor NetTcpBinding. Dit is een veilige, betrouwbare, geoptimaliseerde binding die geschikt is voor communicatie tussen machines. Standaard wordt er een runtimecommunicatiestack gegenereerd die TCP ondersteunt voor berichtbezorging en Windows-beveiliging voor berichtbeveiliging en -verificatie, WS-ReliableMessaging voor betrouwbaarheid en binaire berichtcodering.

Deze klasse wordt geïnstantieerd door de NetTcpBinding, en kan worden geopend door een alleen-lezen eigenschap met de naam Security. Omdat deze eigenschap het kenmerk Alleen-lezen heeft, kunt u geen wijzigingen aanbrengen in het geretourneerde object. Als u het maken van het NetTcpSecurity object wilt beheren, kunt u een klasse afleiden van NetTcpBinding.