Binding Classe

Definição

public ref class Binding abstract : System::ServiceModel::IDefaultCommunicationTimeouts

public abstract class Binding : System.ServiceModel.IDefaultCommunicationTimeouts

type Binding = class
    interface IDefaultCommunicationTimeouts

Public MustInherit Class Binding
Implements IDefaultCommunicationTimeouts

Herança

Object

Binding

Derivado

System.ServiceModel.BasicHttpBinding

System.ServiceModel.Channels.CustomBinding

System.ServiceModel.HttpBindingBase

System.ServiceModel.MsmqBindingBase

System.ServiceModel.NetNamedPipeBinding

Mais…

Implementações

IDefaultCommunicationTimeouts

Exemplos

BasicHttpBinding binding = new BasicHttpBinding();

binding.Name = "binding1";

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");
Uri address = new Uri("http://localhost:8000/servicemodelsamples/service/calc");

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

    // Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();
    // Close the ServiceHostBase to shutdown the service.
    serviceHost.Close();
}

Observações

Representa um conjunto de elementos de ligação, cada um dos quais descreve um aspeto de como um endpoint comunica com outros endpoints e que são construídos, de forma consistente, numa fábrica de canal no cliente e num ouvinte de canal no serviço. Uma ligação contém um conjunto de elementos de ligação que correspondem a canais de protocolo, canais de transporte e codificadores de mensagens. Pode haver qualquer número de elementos de ligação para canais de protocolo, mas apenas um elemento de ligação para cada um do codificador de transporte e de mensagens. Normalmente existem seis camadas de elementos de ligação numa ligação. São necessários apenas os elementos de ligação de transporte e codificação na base da pilha. Como é necessária uma codificação para cada binding, se não for especificada a codificação, o Windows Communication Foundation (WCF) adiciona uma codificação padrão para si. O padrão é Text/XML para os transportes HTTP e HTTPS, e Binary para outros transportes.

A tabela a seguir resume as opções para cada camada.

Cada elemento de ligação fornece a especificação para construir uma fábrica de canais no cliente e um ouvinte de canal no serviço. Quando a pilha de fábrica de canais é construída, por exemplo, existe uma fábrica de canais na pilha para cada elemento de ligação na ligação. O mesmo tipo de mapeamento aplica-se aos ouvintes de canais na pilha do serviço. A consistência entre o cliente e o serviço é fundamental para estabelecer a ligação baseada em canal entre estes endpoints. Cada fábrica e ouvinte, por sua vez, processa o envio e a aceitação dos canais correspondentes na pilha de canais que os liga, e estes canais podem então enviar e receber as mensagens usadas para comunicar.

Cada instância de a Binding tem um Name e Namespace que juntos a identificam de forma única nos metadados do serviço. Se não for especificado nome ou espaço de nomes, o WCF adiciona valores predefinidos para si. O nome padrão é null e o espaço de nomes padrão é http://tempuri.org/. Este nome de utilizador para a ligação é distinto da especificação do nome do protocolo, que é especificada pela Scheme propriedade. Se quiseres adicionar mais bindings HTTP, por exemplo, podes nomeá-los como quiseres e definir todos os seus esquemas para "http". Não existe uma aplicação inerente ou despacho de máquina baseado no Scheme. Assim, evita-se o problema comum de não conseguir registar manipuladores adicionais para protocolos bem conhecidos. Também pode facilmente trabalhar com múltiplas versões de uma encadernação lado a lado, dando a cada versão um nome diferente.

A Binding classe implementa a IDefaultCommunicationTimeouts interface para mitigar ataques de Negação de Serviço (DOS) que dependem de ocupar recursos durante longos períodos de tempo. A implementação especifica os valores de timeout de comunicação para abertura e encerramento de ligações e para as operações de leitura e escrita associadas à receção e envio de mensagens. As propriedades usadas para obter e definir estes timeouts e as suas operações de valores padrão são resumidas na tabela seguinte.

Quando cria uma ligação ao herdar de Binding, tem de sobrescrever CreateBindingElements.

Além disso, pode definir os seus próprios elementos de ligação e inseri-los entre qualquer uma das camadas definidas na tabela anterior. Para obter mais informações, consulte a classe CustomBinding.