NetNamedPipeBinding NetNamedPipeBinding NetNamedPipeBinding NetNamedPipeBinding Class

Definition

Bietet eine sichere und zuverlässige Bindung, die für die computerinterne Kommunikation optimiert ist.Provides a secure and reliable binding that is optimized for on-machine communication.

public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type NetNamedPipeBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class NetNamedPipeBinding
Inherits Binding
Implements IBindingRuntimePreferences
Vererbung
NetNamedPipeBindingNetNamedPipeBindingNetNamedPipeBindingNetNamedPipeBinding
Implementiert

Beispiele

Im folgenden Beispiel ist der Teil der Konfigurationsdatei dargestellt, der den Abschnitt für NetNamedPipeBinding mit Standardwerten enthält.The following example shows the part of the configuration file that contains the section for the NetNamedPipeBinding with values set to defaults.

Im folgenden Beispiel wird veranschaulicht, wie eine NetNamedPipeBinding-Klasse programmgesteuert verwendet wird.The following example shows how to programmatically use the NetNamedPipeBinding class.

   [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

NetNamedPipeBinding generiert standardmäßig eine Laufzeitkommunikation, die Transportsicherheit, Named Pipes zur Nachrichtenübermittlung und eine binäre Nachrichtencodierung verwendet.The NetNamedPipeBinding generates a run-time communication stack by default, which uses transport security, named pipes for message delivery, and a binary message encoding. Diese Bindung ist eine entsprechende vom System bereitgestellte Windows Communication Foundation (WCF)-Wahl für die computerinterne Kommunikation.This binding is an appropriate Windows Communication Foundation (WCF) system-provided choice for on-machine communication. Sie unterstützt auch Transaktionen.It also supports transactions.

Die Standardkonfiguration für NetNamedPipeBinding ähnelt der Konfiguration, die von NetTcpBinding bereitgestellt wird, sie ist jedoch einfacher, da die WCF-Implementierung nur für die computerinterne Verwendung konzipiert ist und daher weniger Funktionen verfügbar sind.The default configuration for the NetNamedPipeBinding is similar to the configuration provided by the NetTcpBinding, but it is simpler because the WCF implementation is only meant for on-machine use and consequently there are fewer exposed features. Der wichtigste Unterschied besteht darin, dass die SecurityMode-Einstellung nur die Optionen None und Transport anbietet.The most notable difference is that the SecurityMode setting only offers the None and Transport options. SOAP-Sicherheitsunterstützung ist keine eingeschlossene Option.SOAP security support is not an included option. Das Sicherheitsverhalten ist mit dem optionalen securityMode-Parameter im Konstruktor NetNamedPipeBinding(NetNamedPipeSecurityMode) konfigurierbar.The security behavior is configurable using the optional securityMode parameter in NetNamedPipeBinding(NetNamedPipeSecurityMode) the constructor.

Konstruktoren

NetNamedPipeBinding() NetNamedPipeBinding() NetNamedPipeBinding() NetNamedPipeBinding()

Initialisiert eine neue Instanz der NetNamedPipeBinding-Klasse.Initializes a new instance of the NetNamedPipeBinding class.

NetNamedPipeBinding(NetNamedPipeSecurityMode) NetNamedPipeBinding(NetNamedPipeSecurityMode) NetNamedPipeBinding(NetNamedPipeSecurityMode) NetNamedPipeBinding(NetNamedPipeSecurityMode)

Initialisiert eine neue Instanz der NetNamedPipeBinding-Klasse mit einem angegebenen Sicherheitsmodus.Initializes a new instance of the NetNamedPipeBinding class with a specified security mode.

NetNamedPipeBinding(String) NetNamedPipeBinding(String) NetNamedPipeBinding(String) NetNamedPipeBinding(String)

Initialisiert eine neue Instanz der NetNamedPipeBinding-Klasse mit einem angegebenen Konfigurationsnamen.Initializes a new instance of the NetNamedPipeBinding class with a specified configuration name.

Eigenschaften

CloseTimeout CloseTimeout CloseTimeout CloseTimeout

Ruft das Zeitintervall ab, das für eine Verbindung eingerichtet ist, die geschlossen wird, bevor ein Transport eine Ausnahme auslöst, oder legt dieses fest.Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Inherited from Binding)
EnvelopeVersion EnvelopeVersion EnvelopeVersion EnvelopeVersion

Ruft die SOAP-Version ab, die für Nachrichten verwendet wird, die von dieser Bindung verarbeitet werden.Gets the version of SOAP that is used for messages processed by this binding.

HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Hostname zum Erreichen des Diensts bei übereinstimmendem URI verwendet werden soll.Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

Ruft die maximale Anzahl an Bytes ab, die verwendet wird, um eingehende Nachrichten im Arbeitsspeicher zu puffern, oder legt diese Anzahl fest.Gets or sets the maximum number of bytes that are used to buffer incoming messages in memory.

MaxBufferSize MaxBufferSize MaxBufferSize MaxBufferSize

Ruft die maximale Anzahl an Bytes ab, die verwendet wird, um eingehende Nachrichten im Arbeitsspeicher zu puffern, oder legt diese Anzahl fest.Gets or sets the maximum number of bytes used to buffer incoming messages in memory.

MaxConnections MaxConnections MaxConnections MaxConnections

Ruft die maximale Anzahl aus- und eingehender Verbindungen ab, die für mit der benannten Pipebindung konfigurierte Endpunkte zulässig ist, oder legt diese Anzahl fest.Gets or sets the maximum number of connections, both inbound and outbound, that are allowed to endpoints configured with the named pipe binding.

MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize

Ruft die maximale Größe in Byte für eine empfangene Nachricht ab, die von der Bindung verarbeitet wird, oder legt sie fest.Gets or sets the maximum size, in bytes, for a received message that is processed by the binding.

MessageVersion MessageVersion MessageVersion MessageVersion

Ruft die Nachrichtenversion ab, die von den Clients und Diensten verwendet wird, die mit der Bindung konfiguriert wurden.Gets the message version used by clients and services configured with the binding.

(Inherited from Binding)
Name Name Name Name

Ruft den Namen der Bindung ab oder legt diesen fest.Gets or sets the name of the binding.

(Inherited from Binding)
Namespace Namespace Namespace Namespace

Ruft den XML-Namespace einer Bindung ab oder legt diesen fest.Gets or sets the XML namespace of the binding.

(Inherited from Binding)
OpenTimeout OpenTimeout OpenTimeout OpenTimeout

Ruft das Zeitintervall ab, das für eine Verbindung eingerichtet ist, die geöffnet wird, bevor ein Transport eine Ausnahme auslöst, oder legt dieses fest.Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Inherited from Binding)
ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

Ruft Beschränkungen der Komplexität von SOAP-Meldungen ab, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert werden, oder legt die Beschränkungen fest.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout

Ruft ein Zeitintervall ab oder legt ein Zeitintervall fest, während dessen eine Verbindung inaktiv bleiben kann und keine Anwendungsnachrichten empfangen werden, bevor sie verworfen werden.Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Inherited from Binding)
Scheme Scheme Scheme Scheme

Ruft das URI-Transportschema für die Kanäle und die Listener ab, die mit dieser Bindung konfiguriert werden.Gets the URI transport scheme for the channels and listeners that are configured with this binding.

Security Security Security Security

Ruft ein Objekt ab, das den Sicherheitstyp angibt, der mit den mit dieser Bindung konfigurierten Diensten verwendet wird.Gets an object that specifies the type of security used with services configured with this binding.

SendTimeout SendTimeout SendTimeout SendTimeout

Ruft das Zeitintervall ab, das für einen Schreibvorgang eingerichtet ist, der abgeschlossen wird, bevor ein Transport eine Ausnahme auslöst, oder legt dieses fest.Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Inherited from Binding)
TransactionFlow TransactionFlow TransactionFlow TransactionFlow

Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob Transaktionen zum Dienst übergehen sollten.Gets or sets a value that determines whether transactions should be flowed to the service.

TransactionProtocol TransactionProtocol TransactionProtocol TransactionProtocol

Ruft vom Dienst für den Transaktionsfluss verwendete Transaktionsprotokolle ab oder legt sie fest.Gets or sets the transactions protocol used by the service to flow transactions.

TransferMode TransferMode TransferMode TransferMode

Ruft einen Wert ab, der angibt, ob der mit der Bindung konfigurierte Dienst Streaming- oder Puffermodi (in einer oder beiden Richtungen) für die Nachrichtenübertragung einsetzt, oder legt ihn fest.Gets or sets a value that indicates whether the service configured with the binding uses streamed (in one or both directions) or buffered modes of message transfer.

Methoden

BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection)

Erstellt den Kanalfactorystapel auf dem Client, der einen festgelegten Kanaltyp erstellt und der die Funktionen erfüllt, die von einer Auflistung von Bindungsparametern festgelegt werden.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[])

Erstellt den Kanalfactorystapel auf dem Client, der einen festgelegten Kanaltyp erstellt und der die Funktionen erfüllt, die von einem Objektarray festgelegt werden.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Inherited from Binding)
BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die Funktionen erfüllt, die von einer Auflistung von Bindungsparametern festgelegt werden.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[])

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[])

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[])

Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanalfactorystapel auf dem Client erstellen kann, der die Auflistung festgelegter Bindungsparameter erfüllt.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) 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 festgelegten Anforderungen erfüllt.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection)

Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanallistenerstapel auf dem Dienst erstellen kann, der die Auflistung festgelegter Bindungsparameter erfüllt.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) 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 Objektarray festgelegten Kriterien erfüllt.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Inherited from Binding)
CreateBindingElements() CreateBindingElements() CreateBindingElements() CreateBindingElements()

Erstellt eine Auflistung mit den Bindungselementen für die Bindung.Creates a collection with the binding elements for the binding.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection)

Gibt ggf. ein angefordertes typisiertes Objekt von der entsprechenden Ebene im Bindungsstapel zurück.Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Inherited from Binding)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeMaxConnections() ShouldSerializeMaxConnections() ShouldSerializeMaxConnections() ShouldSerializeMaxConnections()

Gibt einen Wert zurück, der angibt, ob die MaxConnections-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.Returns a value that indicates whether the MaxConnections property has changed from its default value and should be serialized.

ShouldSerializeName() ShouldSerializeName() ShouldSerializeName() ShouldSerializeName()

Gibt einen Wert zurück, der angibt, ob der Name der Bindung serialisiert werden soll.Returns whether the name of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace()

Gibt einen Wert zurück, der angibt, ob der Namespace der Bindung serialisiert werden soll.Returns whether the namespace of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas()

Gibt einen Wert zurück, der angibt, ob die ReaderQuotas-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized. Dies wird von WCF für die XAML-Integration verwendet.This is used by WCF for XAML integration.

ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity()

Gibt einen Wert zurück, der angibt, ob die Security-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.Returns a value that indicates whether the Security property has changed from its default value and should be serialized. Dies wird von WCF für die XAML-Integration verwendet.This is used by WCF for XAML integration.

ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol()

Gibt einen Wert zurück, der angibt, ob die TransactionProtocol-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.Returns a value that indicates whether the TransactionProtocol property has changed from its default value and should be serialized. Dies wird von WCF für die XAML-Integration verwendet.This is used by WCF for XAML integration.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously

Ruft einen Wert ab, der angibt, ob eingehende Anforderungen synchron oder asynchron gehandhabt werden.Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

Gilt für: