Binding Класс

Определение

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

Наследование

Object

Binding

Производный

System.ServiceModel.BasicHttpBinding

System.ServiceModel.Channels.CustomBinding

System.ServiceModel.HttpBindingBase

System.ServiceModel.MsmqBindingBase

System.ServiceModel.NetNamedPipeBinding

Подробнее…

Реализации

IDefaultCommunicationTimeouts

Примеры

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();
}

Комментарии

Представляет коллекцию элементов привязки, каждый из которых описывает определенный аспект взаимодействия конечной точки с другими конечными точками; все эти аспекты единообразно встроены в фабрику каналов на стороне клиента и в прослушиватель каналов на стороне службы. Привязка содержит коллекцию элементов привязки, соответствующих каналам протоколов, каналам транспортов и кодировщикам сообщений. Для каналов протоколов допускается любое количество элементов привязки, но для каждого кодировщика сообщения и транспорта — только один. Обычно привязка содержит шесть уровней элементов привязки. В нижней части стека требуются только элементы привязки кодирования и транспорта. Так как для каждой привязки требуется кодировка, если кодировка не указана, Windows Communication Foundation (WCF) добавляет кодировку по умолчанию. По умолчанию для транспортов HTTP и HTTPS используется текстовое/XML-кодирование, для остальных — двоичное.

В следующей таблице приведены сводные данные по параметрам каждого уровня.

Каждый элемент привязки предоставляет спецификации для создания фабрики канала на клиенте, а также прослушивателя канала в службе. Например, когда создан стек фабрики канала, у каждого элемента привязки в данной привязке есть одна фабрика канала. Такой же тип сопоставления применим к прослушивателям канала в стеке службы. Согласованность клиента и службы критически важна для установления соединения, основанного на каналах, между этими конечными точками. В свою очередь каждая фабрика и прослушиватель выполняют отправку и прием соответствующих каналов в соединяющем их стеке канала, а затем эти каналы могут отправлять и получать сообщения, используемые для взаимодействия.

Каждый экземпляр Binding имеет атрибуты Name и Namespace, которые совместно однозначно идентифицируют привязку в метаданных службы. Если имя или пространство имен не указано, WCF добавляет значения по умолчанию. Имя по умолчанию — , null а пространство имен по умолчанию — http://tempuri.org/. Данное имя пользователя привязки отличается от спецификации имени протокола, которая задана в свойстве Scheme. Например, если требуется добавить еще несколько привязок HTTP, можно задать им любые имена, а их схемам задать значение «http». Не существует собственного приложения или компьютерной диспетчеризации, основанной на Scheme. Тем самым можно избежать распространенной проблемы, когда невозможно зарегистрировать дополнительные обработчики для хорошо известных протоколов. Также можно параллельно работать с несколькими версиями привязки, задав каждой из них различное имя.

Класс Binding реализует интерфейс IDefaultCommunicationTimeouts для ослабления эффекта атак типа "отказ в обслуживании" (DoS), при которых ресурсы блокируются на продолжительный период времени. Реализация задает значения времени ожидания связи для открытия и закрытия соединений и для чтения и записи операций, связанных с получением и отправкой сообщений. Свойства, используемые для получения и установки времени ожидания и значений по умолчанию, приведены в следующей таблице.

При создании привязки путем наследования от класса Binding необходимо переопределить метод CreateBindingElements.

Кроме того, можно определить собственные элементы привязки и вставить их между любыми определенными уровнями из приведенной выше таблицы. Дополнительные сведения см. в описании класса CustomBinding.

Конструкторы

Свойства

Методы

Применяется к