BasicHttpBinding Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет привязку, которую служба Windows Communication Foundation (WCF) может использовать для настройки и предоставления конечных точек, которые могут взаимодействовать с веб-службами и клиентами на основе ASMX и другими службами, которые соответствуют WS-I базовому профилю 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
- Наследование
- Наследование
- Производный
- Реализации
Примеры
В следующем примере показано, как настроить 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 |
Устаревшие..
Возвращает или задает значение, указывающее, включен ли контейнер cookie HTTP. |
| EnvelopeVersion |
Возвращает версию SOAP, которая используется для сообщений, обрабатываемых этой привязкой. |
| EnvelopeVersion |
Возвращает версию SOAP, которая используется для сообщений, обрабатываемых этой привязкой. (Унаследовано от HttpBindingBase) |
| HostNameComparisonMode |
Возвращает или задает значение, указывающее, используется ли имя узла для достижения службы при сопоставлении URI. |
| HostNameComparisonMode |
Возвращает или задает значение, указывающее, используется ли имя узла для достижения службы при сопоставлении URI. (Унаследовано от HttpBindingBase) |
| MaxBufferPoolSize |
Возвращает или задает максимальный объем памяти в байтах, который выделяется для использования диспетчером буферов сообщений, получающих сообщения из канала. |
| MaxBufferPoolSize |
Возвращает или задает максимальный объем памяти в байтах, который выделяется для использования диспетчером буферов сообщений, получающих сообщения из канала. (Унаследовано от HttpBindingBase) |
| MaxBufferSize |
Получает или задает максимальный размер в байтах для буфера, получающего сообщения из канала. |
| MaxBufferSize |
Получает или задает максимальный размер в байтах для буфера, получающего сообщения из канала. (Унаследовано от HttpBindingBase) |
| MaxReceivedMessageSize |
Возвращает или задает максимальный размер сообщения в байтах, которое может быть получено в канале, настроенном с этой привязкой. |
| MaxReceivedMessageSize |
Возвращает или задает максимальный размер сообщения в байтах, которое может быть получено в канале, настроенном с этой привязкой. (Унаследовано от HttpBindingBase) |
| MessageEncoding |
Возвращает или задает, используется ли MTOM или Text для кодирования сообщений SOAP. |
| 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) |