NetNamedPipeBinding Klasse

Definition

Bietet eine sichere und zuverlässige Bindung, die für die Kommunikation auf dem Computer optimiert ist.

public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding
public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type NetNamedPipeBinding = class
    inherit Binding
type NetNamedPipeBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class NetNamedPipeBinding
Inherits Binding
Public Class NetNamedPipeBinding
Inherits Binding
Implements IBindingRuntimePreferences
Vererbung
NetNamedPipeBinding
Attribute
Implementiert

Beispiele

Das folgende Beispiel zeigt den Teil der Konfigurationsdatei, der den Abschnitt für die NetNamedPipeBinding Standardwerte enthält.

Das folgende Beispiel zeigt, wie Sie die NetNamedPipeBinding Klasse programmgesteuert verwenden.

[ServiceContract(Namespace = "http://UE.Samples")]
public interface ICalculator
{
    [OperationContract]
    double Add(double n1, double n2);
}

// Service class which implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }

    public static void Main()
    {
        Uri baseAddress = new Uri("http://localhost:8000/uesamples/service");
        string address = "net.pipe://localhost/uesamples/calc";

        // Create a ServiceHost for the CalculatorService type and provide the base address.
        using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
        {
            NetNamedPipeBinding binding = new NetNamedPipeBinding(NetNamedPipeSecurityMode.None);
            serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, address);

            // Add a mex endpoint
            ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
            smb.HttpGetEnabled = true;
            smb.HttpGetUrl = new Uri("http://localhost:8001/uesamples");
            serviceHost.Description.Behaviors.Add(smb);

    long maxBufferPoolSize = binding.MaxBufferPoolSize;

    int maxBufferSize = binding.MaxBufferSize;

    int maxConnections = binding.MaxConnections;

    long maxReceivedMessageSize =
        binding.MaxReceivedMessageSize;

    NetNamedPipeSecurity security = binding.Security;

    string scheme = binding.Scheme;

    XmlDictionaryReaderQuotas readerQuotas =
        binding.ReaderQuotas;

    BindingElementCollection bCollection = binding.CreateBindingElements();

    HostNameComparisonMode hostNameComparisonMode =
        binding.HostNameComparisonMode;

    bool TransactionFlow = binding.TransactionFlow;

    TransactionProtocol transactionProtocol =
        binding.TransactionProtocol;

    EnvelopeVersion envelopeVersion =
        binding.EnvelopeVersion;

    TransferMode transferMode =
        binding.TransferMode;

            serviceHost.Open();

            Console.WriteLine("The service is ready.");
            Console.WriteLine("Press <ENTER> to terminate service.");
            Console.WriteLine();
            Console.ReadLine();

            serviceHost.Close();
        }
    }

static void SnippetReceiveSynchronously ()
{

    NetNamedPipeBinding binding = new NetNamedPipeBinding();
    IBindingRuntimePreferences s  =
           binding.GetProperty<IBindingRuntimePreferences>
           (new BindingParameterCollection());
    bool receiveSynchronously = s.ReceiveSynchronously;

}
}

Hinweise

Der NetNamedPipeBinding Generiert standardmäßig einen Laufzeitkommunikationsstapel, der Transportsicherheit, benannte Rohre für die Nachrichtenübermittlung und eine binäre Nachrichtencodierung verwendet. Diese Bindung ist eine geeignete Windows Communication Foundation (WCF)-Systemauswahl für die Kommunikation auf Computern. Es unterstützt auch Transaktionen.

Die Standardkonfiguration für die Konfiguration NetNamedPipeBinding ähnelt der von der NetTcpBinding, aber es ist einfacher, da die WCF-Implementierung nur für die Verwendung auf dem Computer vorgesehen ist und folglich weniger verfügbar gemachte Features vorhanden sind. Der wichtigste Unterschied besteht darin, dass die SecurityMode Einstellung nur die None optionen bietet Transport . Die SOAP-Sicherheitsunterstützung ist keine enthaltene Option. Das Sicherheitsverhalten kann mithilfe des optionalen securityMode Parameters im NetNamedPipeBinding(NetNamedPipeSecurityMode) Konstruktor konfiguriert werden.

Konstruktoren

Name Beschreibung
NetNamedPipeBinding()

Initialisiert eine neue Instanz der NetNamedPipeBinding-Klasse.

NetNamedPipeBinding(NetNamedPipeSecurityMode)

Initialisiert eine neue Instanz der NetNamedPipeBinding Klasse mit einem angegebenen Sicherheitsmodus.

NetNamedPipeBinding(String)

Initialisiert eine neue Instanz der NetNamedPipeBinding Klasse mit einem angegebenen Konfigurationsnamen.

Eigenschaften

Name Beschreibung
CloseTimeout

Dient zum Abrufen oder Festlegen des Zeitintervalls, das für eine Verbindung bereitgestellt wird, die geschlossen werden soll, bevor der Transport eine Ausnahme auslöst.

(Geerbt von Binding)
EnvelopeVersion

Ruft die Version von SOAP ab, die für Nachrichten verwendet wird, die von dieser Bindung verarbeitet werden.

HostNameComparisonMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Hostname verwendet wird, um den Dienst beim Abgleichen des URI zu erreichen.

MaxBufferPoolSize

Ruft die maximale Anzahl von Bytes ab, die zum Puffern eingehender Nachrichten im Arbeitsspeicher verwendet werden, oder legt diese fest.

MaxBufferSize

Ruft die maximale Anzahl von Bytes ab, die zum Puffern eingehender Nachrichten im Arbeitsspeicher verwendet werden, oder legt diese fest.

MaxConnections

Ruft die maximale Anzahl von Verbindungen ab, die sowohl eingehend als auch ausgehend sind, die endpunkten zulässig sind, die mit der benannten Pipebindung konfiguriert sind, oder legt diese fest.

MaxReceivedMessageSize

Ruft die maximale Größe in Bytes für eine empfangene Nachricht ab, die von der Bindung verarbeitet wird, oder legt diese fest.

MessageVersion

Ruft die Nachrichtenversion ab, die von Clients und Diensten verwendet wird, die mit der Bindung konfiguriert sind.

(Geerbt von Binding)
Name

Dient zum Abrufen oder Festlegen des Namens der Bindung.

(Geerbt von Binding)
Namespace

Dient zum Abrufen oder Festlegen des XML-Namespace der Bindung.

(Geerbt von Binding)
OpenTimeout

Dient zum Abrufen oder Festlegen des Zeitintervalls, das für eine Verbindung bereitgestellt wird, die geöffnet werden soll, bevor der Transport eine Ausnahme auslöst.

(Geerbt von Binding)
ReaderQuotas

Dient zum Abrufen oder Festlegen von Einschränkungen für die Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind.

ReceiveTimeout

Ruft ab oder legt das Zeitintervall fest, in dem eine Verbindung inaktiv bleiben kann, während der keine Anwendungsnachrichten empfangen werden, bevor sie gelöscht wird.

(Geerbt von Binding)
Scheme

Ruft das URI-Transportschema für die Kanäle und Listener ab, die mit dieser Bindung konfiguriert sind.

Security

Ruft ein Objekt ab, das den Typ der Sicherheit angibt, die mit diesen Diensten verwendet wird, die mit dieser Bindung konfiguriert sind.

SendTimeout

Dient zum Abrufen oder Festlegen des Zeitintervalls, das für einen Schreibvorgang bereitgestellt wird, der abgeschlossen werden soll, bevor der Transport eine Ausnahme auslöst.

(Geerbt von Binding)
TransactionFlow

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob Transaktionen an den Dienst fließen sollen.

TransactionProtocol

Ruft ab oder legt das Transaktionsprotokoll fest, das vom Dienst zum Fluss von Transaktionen verwendet wird.

TransferMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der mit der Bindung konfigurierte Dienst gestreamte (in einer oder beide Richtungen) oder gepufferte Modi der Nachrichtenübertragung verwendet.

Methoden

Name Beschreibung
BuildChannelFactory<TChannel>(BindingParameterCollection)

Erstellt den Kanalfactorystapel auf dem Client, der einen bestimmten Kanaltyp erstellt und die durch eine Sammlung von Bindungsparametern angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelFactory<TChannel>(Object[])

Erstellt den Kanalfactorystapel auf dem Client, der einen bestimmten Kanaltyp erstellt und die von einem Objektarray angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die durch eine Sammlung von Bindungsparametern angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Object[])

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt.

(Geerbt von Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanalfactorystapel auf dem Client erstellen kann, der die Auflistung der angegebenen Bindungsparameter erfüllt.

(Geerbt von Binding)
CanBuildChannelFactory<TChannel>(Object[])

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanalfactorystapel auf dem Client erstellen kann, der die von einem Objektarray angegebenen Anforderungen erfüllt.

(Geerbt von Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanallistenerstapel auf dem Dienst erstellen kann, der die Auflistung der angegebenen Bindungsparameter erfüllt.

(Geerbt von Binding)
CanBuildChannelListener<TChannel>(Object[])

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanallistenerstapel auf dem Dienst erstellen kann, der die in einem Array von Objekten angegebenen Kriterien erfüllt.

(Geerbt von Binding)
CreateBindingElements()

Erstellt eine Auflistung mit den Bindungselementen für die Bindung.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetProperty<T>(BindingParameterCollection)

Gibt ein typiertes Objekt zurück, das ( falls vorhanden) aus der entsprechenden Ebene im Bindungsstapel angefordert wird.

(Geerbt von Binding)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ShouldSerializeMaxConnections()

Gibt einen Wert zurück, der angibt, ob sich die MaxConnections Eigenschaft vom Standardwert geändert hat und serialisiert werden soll.

ShouldSerializeName()

Gibt zurück, ob der Name der Bindung serialisiert werden soll.

(Geerbt von Binding)
ShouldSerializeNamespace()

Gibt zurück, ob der Namespace der Bindung serialisiert werden soll.

(Geerbt von Binding)
ShouldSerializeReaderQuotas()

Gibt einen Wert zurück, der angibt, ob sich die ReaderQuotas Eigenschaft vom Standardwert geändert hat und serialisiert werden soll. Dies wird von WCF für die XAML-Integration verwendet.

ShouldSerializeSecurity()

Gibt einen Wert zurück, der angibt, ob sich die Security Eigenschaft vom Standardwert geändert hat und serialisiert werden soll. Dies wird von WCF für die XAML-Integration verwendet.

ShouldSerializeTransactionProtocol()

Gibt einen Wert zurück, der angibt, ob sich die TransactionProtocol Eigenschaft vom Standardwert geändert hat und serialisiert werden soll. Dies wird von WCF für die XAML-Integration verwendet.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IBindingRuntimePreferences.ReceiveSynchronously

Ruft einen Wert ab, der angibt, ob eingehende Anforderungen synchron oder asynchron verarbeitet werden.

Gilt für: