NetNamedPipeBinding NetNamedPipeBinding NetNamedPipeBinding NetNamedPipeBinding Class

Definición

Proporciona un enlace seguro y confiable que está optimizado para la comunicación en equipo.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
Herencia
NetNamedPipeBindingNetNamedPipeBindingNetNamedPipeBindingNetNamedPipeBinding
Implementaciones

Ejemplos

En el siguiente ejemplo se muestra la parte del archivo de configuración que contiene la sección para NetNamedPipeBinding con valores establecidos con los valores predeterminados.The following example shows the part of the configuration file that contains the section for the NetNamedPipeBinding with values set to defaults.

En el siguiente ejemplo se muestra cómo utilizar mediante programación la clase NetNamedPipeBinding: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;


}
   }

Comentarios

De forma predeterminada, NetNamedPipeBinding genera una pila de comunicaciones en tiempo de ejecución que usa la seguridad de transporte, las canalizaciones con nombre para la entrega de mensajes y una codificación de mensajes binaria.The NetNamedPipeBinding generates a run-time communication stack by default, which uses transport security, named pipes for message delivery, and a binary message encoding. Este enlace es una opción adecuada proporcionada por sistema de Windows Communication Foundation (WCF) para la comunicación en el equipo.This binding is an appropriate Windows Communication Foundation (WCF) system-provided choice for on-machine communication. También admite transacciones.It also supports transactions.

La configuración predeterminada para NetNamedPipeBinding es similar a la configuración proporcionada por NetTcpBinding, pero es más simple, porque la implementación de WCF sólo está destinada a su uso en el equipo y, por consiguiente, hay menos características expuestas.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. La diferencia más notable es que el valor SecurityMode sólo proporciona las opciones None y Transport.The most notable difference is that the SecurityMode setting only offers the None and Transport options. La compatibilidad de seguridad SOAP no es una opción incluida.SOAP security support is not an included option. El comportamiento de seguridad es configurable mediante el parámetro opcional securityMode en NetNamedPipeBinding(NetNamedPipeSecurityMode) el constructor.The security behavior is configurable using the optional securityMode parameter in NetNamedPipeBinding(NetNamedPipeSecurityMode) the constructor.

Constructores

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

Inicializa una nueva instancia de la clase NetNamedPipeBinding.Initializes a new instance of the NetNamedPipeBinding class.

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

Inicializa una nueva instancia de la clase NetNamedPipeBinding con un modo de seguridad especificado.Initializes a new instance of the NetNamedPipeBinding class with a specified security mode.

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

Inicializa una instancia nueva de la clase NetNamedPipeBinding con el nombre de configuración especificado.Initializes a new instance of the NetNamedPipeBinding class with a specified configuration name.

Propiedades

CloseTimeout CloseTimeout CloseTimeout CloseTimeout

Obtiene o establece el intervalo de tiempo proporcionado para que una conexión se cierre antes de que el transporte genere una excepción.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

Obtiene la versión de SOAP que se utiliza para los mensajes procesados por este enlace.Gets the version of SOAP that is used for messages processed by this binding.

HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

Obtiene o establece un valor que indica si el nombre del host se usa para alcanzar el servicio al coincidir con el URI.Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

Obtiene o establece el número máximo de bytes que se utilizan para almacenar en búfer los mensajes entrantes en la memoria.Gets or sets the maximum number of bytes that are used to buffer incoming messages in memory.

MaxBufferSize MaxBufferSize MaxBufferSize MaxBufferSize

Obtiene o establece el número máximo de bytes que se utilizan para almacenar en búfer los mensajes entrantes en memoria.Gets or sets the maximum number of bytes used to buffer incoming messages in memory.

MaxConnections MaxConnections MaxConnections MaxConnections

Obtiene o establece el número máximo de conexiones, entrantes y salientes, permitidas a los puntos de conexión configurados con el enlace de canalización con nombre.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

Obtiene o establece el tamaño máximo, en bytes, para un mensaje recibido que el enlace procesa.Gets or sets the maximum size, in bytes, for a received message that is processed by the binding.

MessageVersion MessageVersion MessageVersion MessageVersion

Obtiene la versión de mensaje usada por los clientes y servicios configurados con el enlace.Gets the message version used by clients and services configured with the binding.

(Inherited from Binding)
Name Name Name Name

Obtiene o establece el nombre del enlace.Gets or sets the name of the binding.

(Inherited from Binding)
Namespace Namespace Namespace Namespace

Obtiene o establece el espacio de nombres XML del enlace.Gets or sets the XML namespace of the binding.

(Inherited from Binding)
OpenTimeout OpenTimeout OpenTimeout OpenTimeout

Obtiene o establece el intervalo de tiempo proporcionado para que una conexión se abra antes de que el transporte genere una excepción.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

Obtiene o establece restricciones en la complejidad de mensajes SOAP que pueden ser procesados por puntos de conexión configurados con este enlace.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout

Obtiene o establece el intervalo de tiempo que una conexión puede permanecer inactiva, durante el cual no se recibe ningún mensaje de la aplicación, antes de interrumpir la conexión.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

Obtiene el esquema de transporte de URI para los canales y agentes de escucha que se configuran con este enlace.Gets the URI transport scheme for the channels and listeners that are configured with this binding.

Security Security Security Security

Obtiene un objeto que especifica el tipo de seguridad utilizado con servicios configurados con este enlace.Gets an object that specifies the type of security used with services configured with this binding.

SendTimeout SendTimeout SendTimeout SendTimeout

Obtiene o establece el intervalo de tiempo proporcionado para que una operación de escritura se complete antes de que el transporte genere una excepción.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

Obtiene o establece un valor que determina si las transacciones se deberían fluir al servicio.Gets or sets a value that determines whether transactions should be flowed to the service.

TransactionProtocol TransactionProtocol TransactionProtocol TransactionProtocol

Obtiene o establece el protocolo de transacciones utilizado por el servicio para el flujo de transacciones.Gets or sets the transactions protocol used by the service to flow transactions.

TransferMode TransferMode TransferMode TransferMode

Obtiene o establece un valor que indica si el servicio configurado con el enlace utiliza modos de transmisión (en una o ambas direcciones) o de almacenamiento en búfer para transferir los mensajes.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.

Métodos

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

Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y satisface las características especificadas por una colección de parámetros de enlace.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[])

Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y eso satisface las características especificadas por una matriz de objetos.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)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y eso satisface las características especificadas por una colección de parámetros de enlace.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[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.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)

Devuelve un valor que indica si el enlace actual puede compilar una pila de generador de canales en el cliente que satisfaga la colección especificada de parámetros de enlace.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[])

Devuelve un valor que indica si el enlace actual puede compilar una pila de generador de canales en el cliente que satisfaga los requisitos especificados por una matriz de objetos.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)

Devuelve un valor que indica si el enlace actual puede compilar un agente de escucha de canal en el servicio que satisfaga la colección especificada de parámetros de enlace.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[])

Devuelve un valor que indica si el enlace actual puede compilar un agente de escucha de canal en el servicio que satisfaga la colección especificada de parámetros de enlace.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()

Crea una colección con los elementos de enlace para el enlace.Creates a collection with the binding elements for the binding.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Devuelve un objeto escrito solicitado de la capa adecuada en la pila de enlace si está presente.Returns a typed object requested, if present, from the appropriate layer in the binding stack.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Devuelve un valor que indica si la propiedad MaxConnections ha cambiado respecto de su valor predeterminado y se debe serializar.Returns a value that indicates whether the MaxConnections property has changed from its default value and should be serialized.

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

Devuelve un valor si se debe serializar el nombre del enlace.Returns whether the name of the binding should be serialized.

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

Devuelve un valor si se debe serializar el espacio de nombres.Returns whether the namespace of the binding should be serialized.

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

Devuelve un valor que indica si la propiedad ReaderQuotas ha cambiado respecto de su valor predeterminado y se debe serializar.Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized. WCF lo utiliza para la integración XAML.This is used by WCF for XAML integration.

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

Devuelve un valor que indica si la propiedad Security ha cambiado respecto de su valor predeterminado y se debe serializar.Returns a value that indicates whether the Security property has changed from its default value and should be serialized. WCF lo utiliza para la integración XAML.This is used by WCF for XAML integration.

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

Devuelve un valor que indica si la propiedad TransactionProtocol ha cambiado respecto de su valor predeterminado y se debe serializar.Returns a value that indicates whether the TransactionProtocol property has changed from its default value and should be serialized. WCF lo utiliza para la integración XAML.This is used by WCF for XAML integration.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

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

Obtiene un valor que indica si las solicitudes de entrada se administran de forma sincrónica o asincrónica.Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

Se aplica a