NetTcpSecurity Klasse

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.NetTcp.dll

Assembly:

System.ServiceModel.dll

Gibt die Sicherheitstypen auf Transportebene und auf Nachrichtenebene an, die von einem mit einer NetTcpBinding konfigurierten Endpunkt verwendet werden.

public ref class NetTcpSecurity sealed

public sealed class NetTcpSecurity

type NetTcpSecurity = class

Public NotInheritable Class NetTcpSecurity

Vererbung

Object

NetTcpSecurity

Beispiele

Der folgende Code zeigt, wie Sie das NetTcpSecurity Objekt aus einem NetTcpBinding Objekt abrufen und die verschiedenen darin enthaltenen Einstellungen ausdrucken:

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

Hinweise

Alle Standardbindungen stellen Parameter zur Steuerung der Sicherheitsanforderungen für Übertragungen bereit. Diese Parameter beinhalten normalerweise den Sicherheitsmodus, mit dem angegeben wurde, ob Sicherheit auf Nachrichtenebene oder auf Übertragungsebene verwendet wird und welcher Clientanmeldeinformationstyp ausgewählt wurde. Basierend auf der mit diesen Parametern bereitgestellten Optionsauswahl wird ein Kanalstapel mit der entsprechenden Sicherheit erstellt.

Die von Windows Communication Foundation (WCF) gelieferten und vom System bereitgestellten Bindungen wurden für einige der gängigsten Szenarioanforderungen entwickelt. Diese Bindungen ermöglichen alle die Angabe von Sicherheitsanforderungen für einige bestimmte Zielszenarien.

NetTcpSecurity stellt die Sicherheitsspezifikationen für NetTcpBinding. Daraus ergibt sich eine sichere, zuverlässige und optimierte Bindung, die computerübergreifende Kommunikation unterstützt. Diese Bindung generiert standardmäßig einen Laufzeitkommunikationsstapel mit TCP für die Nachrichtenübertragung, Windows-Sicherheit für Nachrichtensicherheit und Authentifizierung, WS-Reliable-Messaging für Zuverlässigkeit sowie binäre Nachrichtencodierung.

Diese Klasse wird von dem NetTcpBindingInstanziiert und kann von einer schreibgeschützten Eigenschaft aufgerufen Securitywerden. Da diese Eigenschaft schreibgeschützt ist, können Sie keine Änderungen am zurückgegebenen Objekt vornehmen. Wenn Sie die Erstellung des NetTcpSecurity Objekts steuern möchten, können Sie eine Klasse von NetTcpBinding.

Konstruktoren

NetTcpSecurity()

Initialisiert eine neue Instanz der NetTcpSecurity-Klasse.

Eigenschaften

Message	Ruft den Typ der Sicherheitsanforderungen auf Nachrichtenebene für einen mit einer NetTcpBinding konfigurierten Dienst ab.
Mode	Ruft ab oder legt fest, ob Sicherheit auf Nachrichtenebene und auf Transportebene von einem mit einer NetTcpBinding konfigurierten Endpunkt verwendet werden.
Transport	Ruft den Typ der Sicherheitsanforderungen auf Nachrichtenebene für einen mit einer NetTcpBinding konfigurierten Endpunkt ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)