NetNamedPipeBinding Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma associação segura e confiável que é otimizada para a comunicação em computadores.
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
- Herança
- Atributos
- Implementações
Exemplos
O exemplo a seguir mostra a parte do arquivo de configuração que contém a seção do NetNamedPipeBinding com valores definidos como padrões.
O exemplo a seguir mostra como usar programaticamente a NetNamedPipeBinding classe .
[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;
}
}
Comentários
A NetNamedPipeBinding gera uma pilha de comunicação em tempo de execução por padrão, que usa segurança de transporte, pipes nomeados para entrega de mensagens e uma codificação de mensagem binária. Essa associação é uma opção apropriada fornecida pelo sistema do WCF (Windows Communication Foundation) para comunicação no computador. Ela também permite transações.
A configuração padrão para o NetNamedPipeBinding é semelhante à configuração fornecida pelo NetTcpBinding, mas é mais simples porque a implementação do WCF destina-se apenas ao uso no computador e, consequentemente, há menos recursos expostos. A diferença mais notável é que a configuração SecurityMode oferece apenas as opções None e Transport. O suporte à segurança SOAP não é uma opção incluída. O comportamento de segurança é configurável usando o parâmetro opcional securityMode
no NetNamedPipeBinding(NetNamedPipeSecurityMode) construtor.
Construtores
NetNamedPipeBinding() |
Inicializa uma nova instância da classe NetNamedPipeBinding. |
NetNamedPipeBinding(NetNamedPipeSecurityMode) |
Inicializa uma nova instância da classe NetNamedPipeBinding com um modo de segurança especificado. |
NetNamedPipeBinding(String) |
Inicializa uma nova instância da classe NetNamedPipeBinding com um nome de configuração especificado. |
Propriedades
CloseTimeout |
Obtém ou define o intervalo concedido para que uma conexão seja fechada antes que o transporte gere uma exceção. (Herdado de Binding) |
EnvelopeVersion |
Obtém a versão do SOAP usada para as mensagens processadas por essa associação. |
HostNameComparisonMode |
Obtém ou define um valor que indica se o nome do host é usado para acessar o serviço ao corresponder ao URI. |
MaxBufferPoolSize |
Obtém ou define o número máximo de bytes que são usados para armazenar em buffer as mensagens de entrada na memória. |
MaxBufferSize |
Obtém ou define o número máximo de bytes usados para armazenar em buffer as mensagens de entrada na memória. |
MaxConnections |
Obtém ou define o número máximo de conexões de entrada e saídas, que têm permissão para pontos de extremidade configurados com a associação de pipe nomeado. |
MaxReceivedMessageSize |
Obtém ou define o tamanho máximo, em bytes, de uma mensagem recebida processada pela associação. |
MessageVersion |
Obtém a versão de mensagem usada por clientes e serviços configurados com a associação. (Herdado de Binding) |
Name |
Obtém ou define o nome da associação. (Herdado de Binding) |
Namespace |
Obtém ou define o namespace de XML da associação. (Herdado de Binding) |
OpenTimeout |
Obtém ou define o intervalo concedido para que uma conexão seja aberta antes que o transporte gere uma exceção. (Herdado de Binding) |
ReaderQuotas |
Obtém ou define as restrições na complexidade das mensagens SOAP que podem ser processadas por pontos de extremidade configurados com essa associação. |
ReceiveTimeout |
Obtém ou define o intervalo de tempo que uma conexão pode permanecer inativa, durante o qual nenhuma mensagem de aplicativo é recebida, antes de seu descarte. (Herdado de Binding) |
Scheme |
Obtém o esquema de transporte de URI para os canais e os ouvintes que estão configurados com essa associação. |
Security |
Obtém um objeto que especifica o tipo de segurança usado com serviços configurados com esta associação. |
SendTimeout |
Obtém ou define o intervalo concedido para uma operação ser concluída antes de o transporte gerar uma exceção. (Herdado de Binding) |
TransactionFlow |
Obtém ou define um valor que determina se as transações devem fluir para o serviço. |
TransactionProtocol |
Obtém ou define o protocolo de transações usado pelo serviço para transações de fluxo. |
TransferMode |
Obtém ou define um valor que indica se o serviço configurado com a associação usa os modos de transferência de mensagens por streaming (em um ou ambos os sentidos) ou em buffer. |
Métodos
BuildChannelFactory<TChannel>(BindingParameterCollection) |
Cria a pilha de fábricas de canais no cliente que cria um tipo de canal especificado e que satisfaz os recursos especificados por uma coleção de parâmetros de associação. (Herdado de Binding) |
BuildChannelFactory<TChannel>(Object[]) |
Cria a pilha de fábricas de canais no cliente que cria um tipo de canal especificado e que satisfaz os recursos especificados por uma matriz de objetos. (Herdado de Binding) |
BuildChannelListener<TChannel>(BindingParameterCollection) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados por uma coleção de parâmetros de associação. (Herdado de Binding) |
BuildChannelListener<TChannel>(Object[]) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
BuildChannelListener<TChannel>(Uri, Object[]) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
BuildChannelListener<TChannel>(Uri, String, Object[]) |
Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados. (Herdado de Binding) |
CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Retorna um valor que indica se a associação atual pode criar uma pilha de fábricas de canais no cliente que satisfaz a coleção de parâmetros de associação especificados. (Herdado de Binding) |
CanBuildChannelFactory<TChannel>(Object[]) |
Retorna um valor que indica se a associação atual pode criar uma pilha de fábricas de canais no cliente que satisfaz os requisitos especificados por uma matriz de objetos. (Herdado de Binding) |
CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Retorna um valor que indica se a associação atual pode criar uma pilha de ouvintes de canais no serviço que satisfaça a coleção de parâmetros de associação especificados. (Herdado de Binding) |
CanBuildChannelListener<TChannel>(Object[]) |
Retorna um valor que indica se a associação atual pode criar uma pilha de ouvintes de canais no serviço que satisfaça os critérios especificados em uma matriz de objetos. (Herdado de Binding) |
CreateBindingElements() |
Cria uma coleção com os elementos de associação para a associação. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetProperty<T>(BindingParameterCollection) |
Retorna um objeto tipado solicitado, se presente, da camada apropriada na pilha de associação. (Herdado de Binding) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ShouldSerializeMaxConnections() |
Retorna um valor que indica se a propriedade MaxConnections foi alterada do valor padrão e se deve ser serializada. |
ShouldSerializeName() |
Retorna se o nome da associação deve ser serializado. (Herdado de Binding) |
ShouldSerializeNamespace() |
Retorna se o namespace da associação deve ser serializado. (Herdado de Binding) |
ShouldSerializeReaderQuotas() |
Retorna um valor que indica se a propriedade ReaderQuotas foi alterada do valor padrão e se deve ser serializada. Isso é usado pelo WCF para integração de XAML. |
ShouldSerializeSecurity() |
Retorna um valor que indica se a propriedade Security foi alterada do valor padrão e se deve ser serializada. Isso é usado pelo WCF para integração de XAML. |
ShouldSerializeTransactionProtocol() |
Retorna um valor que indica se a propriedade TransactionProtocol foi alterada do valor padrão e se deve ser serializada. Isso é usado pelo WCF para integração de XAML. |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
IBindingRuntimePreferences.ReceiveSynchronously |
Obtém um valor que indica se as solicitações de entrada são tratadas de forma síncrona ou assíncrona. |