BasicHttpBinding Класс

Ссылка

Определение

Пространство имен:: System.ServiceModel

Сборка:: System.ServiceModel.Http.dll

Сборка:: System.ServiceModel.dll

Пакет:: System.ServiceModel.Http v8.0.0

Исходный код:: BasicHttpBinding.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет привязку, которую служба Windows Communication Foundation (WCF) может использовать для настройки и предоставления конечных точек, способных связываться с веб-службами на основе ASMX, а также клиентами и другими службами, соответствующими WS-I Basic Profile 1.1.

public ref class BasicHttpBinding : System::ServiceModel::HttpBindingBase

public ref class BasicHttpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences

public class BasicHttpBinding : System.ServiceModel.HttpBindingBase

public class BasicHttpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences

type BasicHttpBinding = class
    inherit HttpBindingBase

type BasicHttpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences

Public Class BasicHttpBinding
Inherits HttpBindingBase

Public Class BasicHttpBinding
Inherits Binding
Implements IBindingRuntimePreferences

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

Binding

HttpBindingBase
BasicHttpBinding

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

Binding
BasicHttpBinding

Производный: System.ServiceModel.BasicHttpContextBinding

Реализации: IBindingRuntimePreferences

Примеры

В следующем примере показано, как настраивать BasicHttpBinding в файле конфигурации приложения.

В приведенном ниже примере показан программный способ настройки BasicHttpBinding.

[ServiceContract(Namespace = "http://UE.ServiceModel.Samples")]
public interface ICalculator
{
    [OperationContract(IsOneWay = false)]
    double Add(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Subtract(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Multiply(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Divide(double n1, double n2);
}

public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        double result = n1 + n2;
        Console.WriteLine("Received Add({0},{1})", n1, n2);
        Console.WriteLine("Return: {0}", result);
        return result;
    }

    public double Subtract(double n1, double n2)
    {
        double result = n1 - n2;
        Console.WriteLine("Received Subtract({0},{1})", n1, n2);
        Console.WriteLine("Return: {0}", result);
        return result;
    }

    public double Multiply(double n1, double n2)
    {
        double result = n1 * n2;
        Console.WriteLine("Received Multiply({0},{1})", n1, n2);
        Console.WriteLine("Return: {0}", result);
        return result;
    }

    public double Divide(double n1, double n2)
    {
        double result = n1 / n2;
        Console.WriteLine("Received Divide({0},{1})", n1, n2);
        Console.WriteLine("Return: {0}", result);
        return result;
    }

    public static void Main()
    {
        BasicHttpBinding binding = new BasicHttpBinding();
        binding.Name = "binding1";
        binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;
        binding.Security.Mode = BasicHttpSecurityMode.None;

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

    }
}

   <ServiceContract(Namespace:="http://UE.ServiceModel.Samples")> _
   Public Interface ICalculator

       <OperationContract()> _
       Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
       <OperationContract()> _
       Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
       <OperationContract()> _
       Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
       <OperationContract()> _
       Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
   End Interface

   ' Service class which implements the service contract.
   ' Added code to write output to the console window
   Public Class CalculatorService
       Implements ICalculator

       Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Add

           Dim result As Double = n1 + n2
           Console.WriteLine("Received Add({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Subtract

           Dim result As Double = n1 - n2
           Console.WriteLine("Received Subtract({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Multiply

           Dim result As Double = n1 * n2
           Console.WriteLine("Received Multiply({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Divide

           Dim result As Double = n1 / n2
           Console.WriteLine("Received Divide({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Shared Sub Main()
           Dim binding As BasicHttpBinding = New BasicHttpBinding()
           binding.Name = "binding1"
           binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard
           binding.Security.Mode = BasicHttpSecurityMode.None

           Dim baseAddress As Uri = New Uri("http://localhost:8000/servicemodelsamples/service")
           Dim address As Uri = New Uri("http://localhost:8000/servicemodelsamples/service/calc")

           ' Create a ServiceHost for the CalculatorService type and provide the base address.
           Using serviceHost As ServiceHost = New ServiceHost(GetType(CalculatorService), baseAddress)

               serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, address)

               ' Open the ServiceHost 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 ServiceHost to shutdown the service.
               serviceHost.Close()
           End Using
       End Sub
   End Class

Привязка BasicHttpBinding использует протокол HTTP в качестве транспорта для отправки сообщений SOAP версии 1.1. Служба может использовать эту привязку для предоставления конечных точек, соответствующих профилю WS-I BP 1.1, например тех, что используют клиенты ASMX. Аналогичным образом клиент может использовать BasicHttpBinding для взаимодействия со службами, предоставляющими конечные точки, соответствующие WS-I BP 1.1, например веб-службы ASMX или службы Windows Communication Foundation (WCF), настроенные с BasicHttpBindingпомощью .

По умолчанию система безопасности отключена, но может быть добавлена присвоением BasicHttpSecurityMode значения, отличного от None в конструкторе BasicHttpBinding(BasicHttpSecurityMode). По умолчанию используется кодировка сообщений «Text» и кодировка текста «UTF-8».

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

BasicHttpBinding()	Инициализирует новый экземпляр класса BasicHttpBinding.
BasicHttpBinding(BasicHttpSecurityMode)	Инициализирует новый экземпляр класса BasicHttpBinding с указанным типом безопасности, используемым привязкой.
BasicHttpBinding(String)	Инициализирует новый экземпляр класса BasicHttpBinding привязкой, заданной именем ее конфигурации.

Свойства

AllowCookies	Возвращает или задает значение, определяющее, принимает ли клиент файлы cookie и распространяет ли он их на будущие запросы.
AllowCookies	Возвращает или задает значение, определяющее, принимает ли клиент файлы cookie и распространяет ли он их на будущие запросы. (Унаследовано от HttpBindingBase)
BypassProxyOnLocal	Возвращает или задает значение, которое указывает, следует ли обходить прокси-сервер при работе с локальными адресами.
BypassProxyOnLocal	Возвращает или задает значение, которое указывает, следует ли обходить прокси-сервер при работе с локальными адресами. (Унаследовано от HttpBindingBase)
CloseTimeout	Возвращает или задает интервал времени для закрытия подключения до того, как транспорт создаст исключение. (Унаследовано от Binding)
EnableHttpCookieContainer	Устаревшие.. Получает или задает значение, указывающее, включен ли HTTP-контейнер файлов cookie.
EnvelopeVersion	Возвращает версию протокола SOAP, используемого для сообщений, обрабатываемых этой привязкой.
EnvelopeVersion	Возвращает версию протокола SOAP, используемого для сообщений, обрабатываемых этой привязкой. (Унаследовано от HttpBindingBase)
HostNameComparisonMode	Возвращает или задает значение, которое указывает, используется ли имя узла для доступа к службе при сравнении по универсальному коду ресурса (URI).
HostNameComparisonMode	Возвращает или задает значение, которое указывает, используется ли имя узла для доступа к службе при сравнении по универсальному коду ресурса (URI). (Унаследовано от HttpBindingBase)
MaxBufferPoolSize	Получает или задает число, определяющее максимальный объем (в байтах) памяти, выделяемый диспетчером буфера сообщений, принимающим сообщения из канала.
MaxBufferPoolSize	Получает или задает число, определяющее максимальный объем (в байтах) памяти, выделяемый диспетчером буфера сообщений, принимающим сообщения из канала. (Унаследовано от HttpBindingBase)
MaxBufferSize	Получает или задает максимальный размер (в байтах) буфера, который получает сообщения из канала.
MaxBufferSize	Получает или задает максимальный размер (в байтах) буфера, который получает сообщения из канала. (Унаследовано от HttpBindingBase)
MaxReceivedMessageSize	Получает или задает максимальный размер (в байтах) сообщения, которое можно получить по каналу, настроенному с этой привязкой.
MaxReceivedMessageSize	Получает или задает максимальный размер (в байтах) сообщения, которое можно получить по каналу, настроенному с этой привязкой. (Унаследовано от HttpBindingBase)
MessageEncoding	Возвращает или задает значение, указывающее формат, используемый для кодирования сообщений SOAP (MTOM или текст).
MessageVersion	Возвращает версию сообщения, используемую клиентами и службами, настроенными с использованием привязки. (Унаследовано от Binding)
Name	Возвращает или задает имя привязки. (Унаследовано от Binding)
Namespace	Возвращает или задает пространство имен XML привязки. (Унаследовано от Binding)
OpenTimeout	Возвращает или задает интервал времени для открытия подключения до того, как транспорт создаст исключение. (Унаследовано от Binding)
ProxyAddress	Возвращает или задает URI-адрес прокси-сервера HTTP.
ProxyAddress	Возвращает или задает URI-адрес прокси-сервера HTTP. (Унаследовано от HttpBindingBase)
ReaderQuotas	Возвращает или задает ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с этой привязкой.
ReaderQuotas	Получает или задает ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с этой привязкой. (Унаследовано от HttpBindingBase)
ReceiveTimeout	Возвращает или задает интервал времени бездействия подключения, в течение которого сообщения приложения не получаются, до его сброса. (Унаследовано от Binding)
Scheme	Возвращает схему транспорта URI для каналов и прослушивателей, настроенных с этой привязкой.
Scheme	Возвращает схему транспорта URI для каналов и прослушивателей, настроенных с этой привязкой. (Унаследовано от HttpBindingBase)
Security	Возвращает тип безопасности, используемый с данной привязкой.
SendTimeout	Возвращает или задает интервал времени для завершения операции записи до того, как транспорт создаст исключение. (Унаследовано от Binding)
TextEncoding	Возвращает или задает кодировку, используемую в тексте сообщений.
TextEncoding	Возвращает или задает кодировку, используемую в тексте сообщений. (Унаследовано от HttpBindingBase)
TransferMode	Возвращает или задает значение, указывающее, следует ли буферизировать отправляемые сообщения или передавать их потоком.
TransferMode	Возвращает или задает значение, указывающее, следует ли буферизировать отправляемые сообщения или передавать их потоком. (Унаследовано от HttpBindingBase)
UseDefaultWebProxy	Возвращает или задает значение, определяющее, должен ли использоваться автоматически настроенный прокси-сервер HTTP системы, если он доступен.
UseDefaultWebProxy	Возвращает или задает значение, определяющее, должен ли использоваться автоматически настроенный прокси-сервер HTTP системы, если он доступен. (Унаследовано от HttpBindingBase)

Методы

BuildChannelFactory<TChannel>(BindingParameterCollection)	Выполняет построение на клиенте стека фабрики каналов, создающего каналы заданного типа и удовлетворяющего заданным коллекцией привязки параметрам.
BuildChannelFactory<TChannel>(BindingParameterCollection)	Выполняет построение на клиенте стека фабрики каналов, создающего каналы заданного типа и удовлетворяющего заданным коллекцией привязки параметрам. (Унаследовано от Binding)
BuildChannelFactory<TChannel>(Object[])	Выполняет построение на клиенте стека фабрики каналов, создающего каналы заданного типа и удовлетворяющего заданным массивом объектов параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным коллекцией привязки параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Object[])	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Выполняет построение на стороне службы прослушивателя каналов, принимающего каналы заданного типа и удовлетворяющего заданным параметрам. (Унаследовано от Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Возвращает значение, указывающее, может ли текущая привязка выполнить построение на клиенте стека фабрики каналов, удовлетворяющего заданной коллекции параметров привязки. (Унаследовано от Binding)
CanBuildChannelFactory<TChannel>(Object[])	Возвращает значение, указывающее, может ли текущая привязка выполнить построение на клиенте стека фабрики каналов, удовлетворяющего заданным массивом объектов требованиям. (Унаследовано от Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Возвращает значение, указывающее, может ли текущая привязка выполнить построение на стороне службы стека прослушивателя каналов, удовлетворяющего заданной коллекции параметров привязки. (Унаследовано от Binding)
CanBuildChannelListener<TChannel>(Object[])	Возвращает значение, указывающее, может ли текущая привязка выполнить построение на стороне службы стека прослушивателя каналов, удовлетворяющего заданным в массиве объектов критериям. (Унаследовано от Binding)
CreateBindingElements()	Создает и возвращает упорядоченную коллекцию элементов привязки, содержащихся в текущей привязке.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetProperty<T>(BindingParameterCollection)	Возвращает запрошенный типизированный объект, если он имеется, из соответствующего уровня стека привязок. (Унаследовано от Binding)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ShouldSerializeEnableHttpCookieContainer()	Указывает, должен ли контейнер файлов cookie HTTP включать сериализацию.
ShouldSerializeName()	Возвращает значение, которое указывает, должно ли быть сериализовано имя привязки. (Унаследовано от Binding)
ShouldSerializeNamespace()	Возвращает значение, которое указывает, должно ли быть сериализовано пространство имен привязки. (Унаследовано от Binding)
ShouldSerializeReaderQuotas()	Возвращает значение, которое указывает, нужно ли сериализовать ограничения по значению, заданные для структуры сообщения SOAP.
ShouldSerializeReaderQuotas()	Возвращает значение, которое указывает, нужно ли сериализовать ограничения по значению, заданные для структуры сообщения SOAP. (Унаследовано от HttpBindingBase)
ShouldSerializeSecurity()	Возвращает значение, указывающее, должны ли быть сериализованы параметры безопасности в зависимости от того, происходит ли уже сериализация, например, на уровне сообщений или транспорта.
ShouldSerializeTextEncoding()	Возвращает значение, которое указывает, должны ли быть сериализованы параметры для кодировки текста.
ShouldSerializeTextEncoding()	Возвращает значение, которое указывает, должны ли быть сериализованы параметры для кодировки текста. (Унаследовано от HttpBindingBase)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

IBindingRuntimePreferences.ReceiveSynchronously	Возвращает значение, указывающее, синхронно или асинхронно обрабатываются входящие запросы.
IBindingRuntimePreferences.ReceiveSynchronously	Возвращает значение, указывающее, синхронно или асинхронно обрабатываются входящие запросы. (Унаследовано от HttpBindingBase)

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

Поделиться через