NetNamedPipeBinding Classe

Definição

Fornece uma associação segura e confiável otimizada para comunicação no computador.

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
NetNamedPipeBinding
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 NetNamedPipeBinding a classe programaticamente.

[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

O NetNamedPipeBinding gera uma pilha de comunicação em tempo de execução por padrão, que usa a 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 Windows Communication Foundation (WCF) para comunicação no computador. Ele também dá suporte a transações.

A configuração padrã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 SecurityMode configuração oferece apenas opções e None opçõesTransport. 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

Nome Description
NetNamedPipeBinding()

Inicializa uma nova instância da classe NetNamedPipeBinding.

NetNamedPipeBinding(NetNamedPipeSecurityMode)

Inicializa uma nova instância da NetNamedPipeBinding classe 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

Nome Description
CloseTimeout

Obtém ou define o intervalo de tempo fornecido 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 que é usada para mensagens processadas por essa associação.

HostNameComparisonMode

Obtém ou define um valor que indica se o nome do host é usado para alcançar o serviço ao corresponder ao URI.

MaxBufferPoolSize

Obtém ou define o número máximo de bytes usados para armazenar mensagens de entrada em buffer na memória.

MaxBufferSize

Obtém ou define o número máximo de bytes usados para armazenar mensagens de entrada em buffer na memória.

MaxConnections

Obtém ou define o número máximo de conexões, tanto de entrada quanto de saída, que têm permissão para pontos de extremidade configurados com a associação de pipe nomeada.

MaxReceivedMessageSize

Obtém ou define o tamanho máximo, em bytes, para uma mensagem recebida que é processada pela associação.

MessageVersion

Obtém a versão da 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 XML da associação.

(Herdado de Binding)
OpenTimeout

Obtém ou define o intervalo de tempo fornecido para que uma conexão seja aberta antes que o transporte gere uma exceção.

(Herdado de Binding)
ReaderQuotas

Obtém ou define restrições sobre a 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 em que uma conexão pode permanecer inativa, durante a qual nenhuma mensagem de aplicativo é recebida, antes de ser descartada.

(Herdado de Binding)
Scheme

Obtém o esquema de transporte de URI para os canais e ouvintes configurados com essa associação.

Security

Obtém um objeto que especifica o tipo de segurança usado com os serviços configurados com essa associação.

SendTimeout

Obtém ou define o intervalo de tempo fornecido para que uma operação de gravação seja concluída antes que o transporte gere uma exceção.

(Herdado de Binding)
TransactionFlow

Obtém ou define um valor que determina se as transações devem ser fluídas para o serviço.

TransactionProtocol

Obtém ou define o protocolo de transações usado pelo serviço para fluir transações.

TransferMode

Obtém ou define um valor que indica se o serviço configurado com a associação usa fluxo (em uma ou ambas as direções) ou modos em buffer de transferência de mensagens.

Métodos

Nome Description
BuildChannelFactory<TChannel>(BindingParameterCollection)

Cria a pilha de fábrica 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ábrica 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 canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados por uma coleção de parâmetros de associação.

(Herdado de Binding)
BuildChannelListener<TChannel>(Object[])

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados.

(Herdado de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Retorna um valor que indica se a associação atual pode criar uma pilha de fábrica de canais no cliente que satisfaça 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ábrica de canais no cliente que atenda aos 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 canal 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 canal no serviço que atenda aos 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 digitado 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 Objectatual.

(Herdado de Object)
ShouldSerializeMaxConnections()

Retorna um valor que indica se a MaxConnections propriedade foi alterada de seu valor padrão e 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 ReaderQuotas propriedade foi alterada de seu valor padrão e deve ser serializada. Isso é usado pelo WCF para integração XAML.

ShouldSerializeSecurity()

Retorna um valor que indica se a Security propriedade foi alterada de seu valor padrão e deve ser serializada. Isso é usado pelo WCF para integração XAML.

ShouldSerializeTransactionProtocol()

Retorna um valor que indica se a TransactionProtocol propriedade foi alterada de seu valor padrão e deve ser serializada. Isso é usado pelo WCF para integração XAML.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
IBindingRuntimePreferences.ReceiveSynchronously

Obtém um valor que indica se as solicitações de entrada são tratadas de forma síncrona ou assíncrona.

Aplica-se a