Udostępnij za pośrednictwem


BasicHttpBinding Klasa

Definicja

Reprezentuje powiązanie, którego usługa Windows Communication Foundation (WCF) może używać do konfigurowania i uwidaczniania punktów końcowych, które mogą komunikować się z usługami sieci Web i klientami opartymi na programie ASMX oraz innymi usługami zgodnymi z profilem podstawowym 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
Dziedziczenie
BasicHttpBinding
Dziedziczenie
BasicHttpBinding
Pochodne
Implementuje

Przykłady

W poniższym przykładzie pokazano, jak skonfigurować element BasicHttpBinding w pliku konfiguracji aplikacji.

W poniższym przykładzie pokazano, jak programowo skonfigurować BasicHttpBindingelement .

[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

Uwagi

Metoda BasicHttpBinding używa protokołu HTTP jako transportu do wysyłania komunikatów PROTOKOŁU SOAP 1.1. Usługa może używać tego powiązania do uwidaczniania punktów końcowych zgodnych z interfejsem WS-I BP 1.1, takich jak te, do których uzyskują dostęp klienci ASMX. Podobnie klient może używać BasicHttpBinding elementu do komunikowania się z usługami uwidacznianymi punktami końcowymi zgodnymi z usługami WS-I BP 1.1, takimi jak usługi sieci Web ASMX lub usługi Windows Communication Foundation (WCF) skonfigurowane za pomocą programu BasicHttpBinding.

Zabezpieczenia są domyślnie wyłączone, ale można je dodać BasicHttpSecurityMode do wartości innej niż None w konstruktorze BasicHttpBinding(BasicHttpSecurityMode) . Domyślnie używa kodowania komunikatów "Text" i kodowania tekstu UTF-8.

Konstruktory

BasicHttpBinding()

Inicjuje nowe wystąpienie klasy BasicHttpBinding.

BasicHttpBinding(BasicHttpSecurityMode)

Inicjuje nowe wystąpienie BasicHttpBinding klasy z określonym typem zabezpieczeń używanym przez powiązanie.

BasicHttpBinding(String)

Inicjuje BasicHttpBinding nowe wystąpienie klasy z powiązaniem określonym przez jego nazwę konfiguracji.

Właściwości

AllowCookies

Pobiera lub ustawia wartość wskazującą, czy klient akceptuje pliki cookie i propaguje je na przyszłych żądaniach.

AllowCookies

Pobiera lub ustawia wartość wskazującą, czy klient akceptuje pliki cookie i propaguje je na przyszłych żądaniach.

(Odziedziczone po HttpBindingBase)
BypassProxyOnLocal

Pobiera lub ustawia wartość wskazującą, czy pominąć serwer proxy dla adresów lokalnych.

BypassProxyOnLocal

Pobiera lub ustawia wartość wskazującą, czy pominąć serwer proxy dla adresów lokalnych.

(Odziedziczone po HttpBindingBase)
CloseTimeout

Pobiera lub ustawia interwał czasu dla połączenia do zamknięcia, zanim transport zgłosi wyjątek.

(Odziedziczone po Binding)
EnableHttpCookieContainer
Przestarzałe.

Pobiera lub ustawia wartość wskazującą, czy kontener plików cookie HTTP jest włączony.

EnvelopeVersion

Pobiera wersję protokołu SOAP, która jest używana w przypadku komunikatów przetwarzanych przez to powiązanie.

EnvelopeVersion

Pobiera wersję protokołu SOAP, która jest używana w przypadku komunikatów przetwarzanych przez to powiązanie.

(Odziedziczone po HttpBindingBase)
HostNameComparisonMode

Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do uzyskiwania dostępu do usługi podczas dopasowywania identyfikatora URI.

HostNameComparisonMode

Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do uzyskiwania dostępu do usługi podczas dopasowywania identyfikatora URI.

(Odziedziczone po HttpBindingBase)
MaxBufferPoolSize

Pobiera lub ustawia maksymalną ilość pamięci w bajtach przydzieloną do użycia przez menedżera buforów komunikatów, które odbierają komunikaty z kanału.

MaxBufferPoolSize

Pobiera lub ustawia maksymalną ilość pamięci w bajtach przydzieloną do użycia przez menedżera buforów komunikatów, które odbierają komunikaty z kanału.

(Odziedziczone po HttpBindingBase)
MaxBufferSize

Pobiera lub ustawia maksymalny rozmiar (w bajtach) dla buforu, który odbiera komunikaty z kanału.

MaxBufferSize

Pobiera lub ustawia maksymalny rozmiar (w bajtach) dla buforu, który odbiera komunikaty z kanału.

(Odziedziczone po HttpBindingBase)
MaxReceivedMessageSize

Pobiera lub ustawia maksymalny rozmiar w bajtach dla komunikatu, który można odebrać w kanale skonfigurowanym za pomocą tego powiązania.

MaxReceivedMessageSize

Pobiera lub ustawia maksymalny rozmiar w bajtach dla komunikatu, który można odebrać w kanale skonfigurowanym za pomocą tego powiązania.

(Odziedziczone po HttpBindingBase)
MessageEncoding

Pobiera lub ustawia, czy funkcja MTOM lub tekst jest używana do kodowania komunikatów PROTOKOŁU SOAP.

MessageVersion

Pobiera wersję komunikatu używaną przez klientów i usługi skonfigurowane za pomocą powiązania.

(Odziedziczone po Binding)
Name

Pobiera lub ustawia nazwę powiązania.

(Odziedziczone po Binding)
Namespace

Pobiera lub ustawia przestrzeń nazw XML powiązania.

(Odziedziczone po Binding)
OpenTimeout

Pobiera lub ustawia interwał czasu dla połączenia, który ma być otwarty, zanim transport zgłosi wyjątek.

(Odziedziczone po Binding)
ProxyAddress

Pobiera lub ustawia adres URI serwera proxy HTTP.

ProxyAddress

Pobiera lub ustawia adres URI serwera proxy HTTP.

(Odziedziczone po HttpBindingBase)
ReaderQuotas

Pobiera lub ustawia ograniczenia dotyczące złożoności komunikatów PROTOKOŁU SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania.

ReaderQuotas

Pobiera lub ustawia ograniczenia dotyczące złożoności komunikatów PROTOKOŁU SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania.

(Odziedziczone po HttpBindingBase)
ReceiveTimeout

Pobiera lub ustawia interwał czasu, przez który połączenie może pozostać nieaktywne, podczas którego nie są odbierane żadne komunikaty aplikacji, zanim zostanie porzucony.

(Odziedziczone po Binding)
Scheme

Pobiera schemat transportu identyfikatora URI dla kanałów i odbiorników skonfigurowanych za pomocą tego powiązania.

Scheme

Pobiera schemat transportu identyfikatora URI dla kanałów i odbiorników skonfigurowanych za pomocą tego powiązania.

(Odziedziczone po HttpBindingBase)
Security

Pobiera typ zabezpieczeń używany z tym powiązaniem.

SendTimeout

Pobiera lub ustawia interwał czasu dla operacji zapisu do ukończenia, zanim transport zgłosi wyjątek.

(Odziedziczone po Binding)
TextEncoding

Pobiera lub ustawia kodowanie znaków używane dla tekstu wiadomości.

TextEncoding

Pobiera lub ustawia kodowanie znaków używane dla tekstu wiadomości.

(Odziedziczone po HttpBindingBase)
TransferMode

Pobiera lub ustawia wartość wskazującą, czy komunikaty są buforowane, czy przesyłane strumieniowo.

TransferMode

Pobiera lub ustawia wartość wskazującą, czy komunikaty są buforowane, czy przesyłane strumieniowo.

(Odziedziczone po HttpBindingBase)
UseDefaultWebProxy

Pobiera lub ustawia wartość wskazującą, czy ma być używany automatycznie skonfigurowany serwer proxy HTTP systemu, jeśli jest dostępny.

UseDefaultWebProxy

Pobiera lub ustawia wartość wskazującą, czy ma być używany automatycznie skonfigurowany serwer proxy HTTP systemu, jeśli jest dostępny.

(Odziedziczone po HttpBindingBase)

Metody

BuildChannelFactory<TChannel>(BindingParameterCollection)

Tworzy stos fabryki kanału na kliencie, który tworzy określony typ kanału i spełnia funkcje określone przez kolekcję parametrów powiązania.

BuildChannelFactory<TChannel>(BindingParameterCollection)

Tworzy stos fabryki kanału na kliencie, który tworzy określony typ kanału i spełnia funkcje określone przez kolekcję parametrów powiązania.

(Odziedziczone po Binding)
BuildChannelFactory<TChannel>(Object[])

Tworzy stos fabryki kanału na kliencie, który tworzy określony typ kanału i spełnia funkcje określone przez tablicę obiektów.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia funkcje określone przez kolekcję parametrów powiązania.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Object[])

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.

(Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos fabryki kanału na kliencie, który spełnia określone parametry powiązania.

(Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(Object[])

Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos fabryki kanału na kliencie, który spełnia wymagania określone przez tablicę obiektów.

(Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos odbiornika kanału w usłudze, który spełnia określone parametry powiązania.

(Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(Object[])

Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos odbiornika kanału w usłudze, który spełnia kryteria określone w tablicy obiektów.

(Odziedziczone po Binding)
CreateBindingElements()

Tworzy i zwraca uporządkowaną kolekcję elementów powiązania zawartych w bieżącym powiązaniu.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetProperty<T>(BindingParameterCollection)

Zwraca żądany obiekt wpisany( jeśli istnieje) z odpowiedniej warstwy w stosie powiązania.

(Odziedziczone po Binding)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ShouldSerializeEnableHttpCookieContainer()

Wskazuje, czy kontener plików cookie http powinien włączyć serializacji.

ShouldSerializeName()

Zwraca, czy nazwa powiązania powinna być serializowana.

(Odziedziczone po Binding)
ShouldSerializeNamespace()

Zwraca, czy przestrzeń nazw powiązania powinna być serializowana.

(Odziedziczone po Binding)
ShouldSerializeReaderQuotas()

Zwraca, czy wartości ograniczeń umieszczone na złożoności struktury komunikatów protokołu SOAP powinny być serializowane.

ShouldSerializeReaderQuotas()

Zwraca, czy wartości ograniczeń umieszczone na złożoności struktury komunikatów protokołu SOAP powinny być serializowane.

(Odziedziczone po HttpBindingBase)
ShouldSerializeSecurity()

Zwraca, czy ustawienia zabezpieczeń powinny być serializowane na podstawie tego, czy serializacja już występuje, na przykład na poziomie komunikatu lub transportu.

ShouldSerializeTextEncoding()

Zwraca, czy ustawienia kodowania tekstu powinny być serializowane.

ShouldSerializeTextEncoding()

Zwraca, czy ustawienia kodowania tekstu powinny być serializowane.

(Odziedziczone po HttpBindingBase)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IBindingRuntimePreferences.ReceiveSynchronously

Pobiera wartość wskazującą, czy żądania przychodzące są obsługiwane synchronicznie, czy asynchronicznie.

IBindingRuntimePreferences.ReceiveSynchronously

Pobiera wartość wskazującą, czy żądania przychodzące są obsługiwane synchronicznie, czy asynchronicznie.

(Odziedziczone po HttpBindingBase)

Dotyczy