BasicHttpBinding Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma ligação que um serviço da Windows Communication Foundation (WCF) pode usar para configurar e expor endpoints capazes de comunicar com serviços Web baseados em ASMX, clientes e outros serviços que cumprem o 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
- Herança
- Herança
- Derivado
- Implementações
Exemplos
O exemplo seguinte mostra como configurar o BasicHttpBinding num ficheiro de configuração de aplicação.
O exemplo seguinte mostra como configurar BasicHttpBindingprogramaticamente .
[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
Observações
Utiliza BasicHttpBinding HTTP como transporte para enviar mensagens SOAP 1.1. Um serviço pode usar esta ligação para expor endpoints que cumprem WS-I BP 1.1, como aqueles a que os clientes ASMX acedem. De forma semelhante, um cliente pode usar o BasicHttpBinding para comunicar com serviços que expõem endpoints que cumprem WS-I BP 1.1, como serviços Web ASMX ou serviços Windows Communication Foundation (WCF) configurados com o BasicHttpBinding.
A segurança está desligada por defeito, mas pode ser adicionada definindo o BasicHttpSecurityMode para um valor diferente do None construtor BasicHttpBinding(BasicHttpSecurityMode) . Utiliza por defeito uma codificação de mensagem "Text" e codificação de texto UTF-8.
Construtores
| Name | Description |
|---|---|
| BasicHttpBinding() |
Inicializa uma nova instância da BasicHttpBinding classe. |
| BasicHttpBinding(BasicHttpSecurityMode) |
Inicializa uma nova instância da BasicHttpBinding classe com um tipo específico de segurança usado pela ligação. |
| BasicHttpBinding(String) |
Inicializa uma nova instância da BasicHttpBinding classe com uma ligação especificada pelo seu nome de configuração. |
Propriedades
| Name | Description |
|---|---|
| AllowCookies |
Recebe ou define um valor que indica se o cliente aceita cookies e propaga-os em pedidos futuros. |
| AllowCookies |
Recebe ou define um valor que indica se o cliente aceita cookies e propaga-os em pedidos futuros. (Herdado de HttpBindingBase) |
| BypassProxyOnLocal |
Recebe ou define um valor que indica se deve contornar o servidor proxy para endereços locais. |
| BypassProxyOnLocal |
Recebe ou define um valor que indica se deve contornar o servidor proxy para endereços locais. (Herdado de HttpBindingBase) |
| CloseTimeout |
Obtém ou define o intervalo de tempo fornecido para que uma ligação se feche antes de o transporte levantar uma exceção. (Herdado de Binding) |
| EnableHttpCookieContainer |
Obsoleto.
Recebe ou define um valor que indica se o contentor de cookies HTTP está ativado. |
| EnvelopeVersion |
Obtém a versão do SOAP usada para mensagens processadas por esta ligação. |
| EnvelopeVersion |
Obtém a versão do SOAP usada para mensagens processadas por esta ligação. (Herdado de HttpBindingBase) |
| HostNameComparisonMode |
Recebe ou define um valor que indica se o nome do host é usado para chegar ao serviço ao corresponder ao URI. |
| HostNameComparisonMode |
Recebe ou define um valor que indica se o nome do host é usado para chegar ao serviço ao corresponder ao URI. (Herdado de HttpBindingBase) |
| MaxBufferPoolSize |
Obtém ou define a quantidade máxima de memória, em bytes, que é alocada para uso pelo gestor dos buffers de mensagens que recebem mensagens do canal. |
| MaxBufferPoolSize |
Obtém ou define a quantidade máxima de memória, em bytes, que é alocada para uso pelo gestor dos buffers de mensagens que recebem mensagens do canal. (Herdado de HttpBindingBase) |
| MaxBufferSize |
Obtém ou define o tamanho máximo, em bytes, para um buffer que recebe mensagens do canal. |
| MaxBufferSize |
Obtém ou define o tamanho máximo, em bytes, para um buffer que recebe mensagens do canal. (Herdado de HttpBindingBase) |
| MaxReceivedMessageSize |
Obtém ou define o tamanho máximo, em bytes, para uma mensagem que pode ser recebida num canal configurado com esta ligação. |
| MaxReceivedMessageSize |
Obtém ou define o tamanho máximo, em bytes, para uma mensagem que pode ser recebida num canal configurado com esta ligação. (Herdado de HttpBindingBase) |
| MessageEncoding |
Obtém ou define se MTOM ou Texto é usado para codificar mensagens SOAP. |
| MessageVersion |
Obtém a versão da mensagem usada por clientes e serviços configurada com a ligação. (Herdado de Binding) |
| Name |
Recebe ou define o nome da ligação. (Herdado de Binding) |
| Namespace |
Obtém ou define o namespace XML do binding. (Herdado de Binding) |
| OpenTimeout |
Obtém ou define o intervalo de tempo fornecido para que uma ligação se abra antes de o transporte levantar uma exceção. (Herdado de Binding) |
| ProxyAddress |
Obtém ou define o endereço URI do proxy HTTP. |
| ProxyAddress |
Obtém ou define o endereço URI do proxy HTTP. (Herdado de HttpBindingBase) |
| ReaderQuotas |
Obtém ou define restrições sobre a complexidade das mensagens SOAP que podem ser processadas por endpoints configurados com esta ligação. |
| ReaderQuotas |
Obtém ou define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas pelos endpoints configurados com esta ligação. (Herdado de HttpBindingBase) |
| ReceiveTimeout |
Obtém ou define o intervalo de tempo em que uma ligação pode permanecer inativa, durante o qual não são recebidas mensagens de aplicação, antes de ser cortada. (Herdado de Binding) |
| Scheme |
Obtém o esquema de transporte URI para os canais e ouvintes configurados com esta ligação. |
| Scheme |
Obtém o esquema de transporte URI para os canais e ouvintes configurados com esta ligação. (Herdado de HttpBindingBase) |
| Security |
Obtém o tipo de segurança usado com esta ligação. |
| SendTimeout |
Obtém ou define o intervalo de tempo fornecido para que uma operação de escrita seja concluída antes de o transporte levantar uma exceção. (Herdado de Binding) |
| TextEncoding |
Obtém ou define a codificação de caracteres usada para o texto da mensagem. |
| TextEncoding |
Obtém ou define a codificação de caracteres usada para o texto da mensagem. (Herdado de HttpBindingBase) |
| TransferMode |
Recebe ou define um valor que indica se as mensagens são enviadas, em buffer ou transmitidas em streaming. |
| TransferMode |
Recebe ou define um valor que indica se as mensagens são enviadas, em buffer ou transmitidas em streaming. (Herdado de HttpBindingBase) |
| UseDefaultWebProxy |
Recebe ou define um valor que indica se o proxy HTTP auto-configurado do sistema deve ser utilizado, se disponível. |
| UseDefaultWebProxy |
Recebe ou define um valor que indica se o proxy HTTP auto-configurado do sistema deve ser utilizado, se disponível. (Herdado de HttpBindingBase) |
Métodos
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Constrói a pilha de channel factory no cliente que cria um tipo específico de canal e que satisfaz as características especificadas por um conjunto de parâmetros de ligação. |
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Constrói a pilha de channel factory no cliente que cria um tipo específico de canal e que satisfaz as características especificadas por um conjunto de parâmetros de ligação. (Herdado de Binding) |
| BuildChannelFactory<TChannel>(Object[]) |
Constrói a stack de channel factory no cliente que cria um tipo específico de canal e que satisfaz as características especificadas por um array de objetos. (Herdado de Binding) |
| BuildChannelListener<TChannel>(BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as características especificadas por um conjunto de parâmetros de ligação. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Devolve um valor que indica se a ligação atual pode construir uma pilha de channel factory no cliente que satisfaz a coleção de parâmetros de ligação especificada. (Herdado de Binding) |
| CanBuildChannelFactory<TChannel>(Object[]) |
Devolve um valor que indica se a ligação atual pode construir uma stack de channel factory no cliente que satisfaz os requisitos especificados por um array de objetos. (Herdado de Binding) |
| CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Devolve um valor que indica se a ligação atual pode construir uma pilha de ouvintes de canal no serviço que satisfaz a coleção de parâmetros de ligação especificada. (Herdado de Binding) |
| CanBuildChannelListener<TChannel>(Object[]) |
Devolve um valor que indica se a ligação atual pode construir uma pilha de ouvintes de canal no serviço que satisfaça os critérios especificados num array de objetos. (Herdado de Binding) |
| CreateBindingElements() |
Cria e devolve uma coleção ordenada de elementos de ligação contidos na ligação atual. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetProperty<T>(BindingParameterCollection) |
Devolve um objeto tipado solicitado, se presente, da camada apropriada na pilha de ligação. (Herdado de Binding) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ShouldSerializeEnableHttpCookieContainer() |
Indica se o contentor de cookies http deve permitir a serialização. |
| ShouldSerializeName() |
Devolve se o nome da ligação deve ser serializado. (Herdado de Binding) |
| ShouldSerializeNamespace() |
Devolve se o namespace da ligação deve ser serializado. (Herdado de Binding) |
| ShouldSerializeReaderQuotas() |
Devolve se os valores de restrição impostos à complexidade da estrutura da mensagem SOAP devem ser serializados. |
| ShouldSerializeReaderQuotas() |
Devolve se os valores de restrição impostos à complexidade da estrutura da mensagem SOAP devem ser serializados. (Herdado de HttpBindingBase) |
| ShouldSerializeSecurity() |
Devolve se as definições de segurança devem ser serializadas com base se a serialização já ocorre, por exemplo, ao nível da mensagem ou do transporte. |
| ShouldSerializeTextEncoding() |
Devolve se as definições de codificação de texto devem ser serializadas. |
| ShouldSerializeTextEncoding() |
Devolve se as definições de codificação de texto devem ser serializadas. (Herdado de HttpBindingBase) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Recebe um valor que indica se os pedidos recebidos são tratados de forma síncrona ou assíncrona. |
| IBindingRuntimePreferences.ReceiveSynchronously |
Recebe um valor que indica se os pedidos recebidos são tratados de forma síncrona ou assíncrona. (Herdado de HttpBindingBase) |