WSHttpBindingBase Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.Http.dll

Pakiet:

System.ServiceModel.Http v8.1.1

Źródło:

WSHttpBindingBase.cs

Udostępnia klasę bazową z elementami wspólnymi dla WSHttpBinding elementów i WSFederationHttpBinding.

C#

public abstract class WSHttpBindingBase : System.ServiceModel.Channels.Binding

Dziedziczenie

Object

Binding

WSHttpBindingBase

Pochodne

System.ServiceModel.WSFederationHttpBinding

System.ServiceModel.WSHttpBinding

Przykłady

W poniższym przykładzie pokazano, jak używać funkcji udostępnianych przez klasę WSHttpBindingBase z klasami WSHttpBinding pochodnymi i WSFederationHttpBinding.

C#

// Define a service contract for the calculator.
[ServiceContract()]
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);
}

// Service class which implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        double result = n1 + n2;
        return result;
    }

    public double Subtract(double n1, double n2)
    {
        double result = n1 - n2;
        return result;
    }

    public double Multiply(double n1, double n2)
    {
        double result = n1 * n2;
        return result;
    }

    public double Divide(double n1, double n2)
    {
        double result = n1 / n2;
        return result;
    }

    // Create and configure bindings within this EXE console application.
    public static void Main()
    {
        // Create a WSHttpBinding
        WSHttpBinding binding1 = new WSHttpBinding();

    binding1.BypassProxyOnLocal =  true;

    EnvelopeVersion envelopeVersion =
    binding1.EnvelopeVersion;

    HostNameComparisonMode hostnameComparisonMode =
    binding1.HostNameComparisonMode;

    long maxBufferPoolSize =
        binding1.MaxBufferPoolSize;

    long maxReceivedMessageSize =
    binding1.MaxReceivedMessageSize;

    WSMessageEncoding messageEncoding =
    binding1.MessageEncoding;

    Uri proxyAddress =
        binding1.ProxyAddress;

    XmlDictionaryReaderQuotas readerQuotas =
    binding1.ReaderQuotas;

    OptionalReliableSession reliableSession =
    binding1.ReliableSession;

    string scheme = binding1.Scheme;

    Encoding textEncoding =
        binding1.TextEncoding;

    bool transactionFlow =
        binding1.TransactionFlow;

    bool useDefaultWebProxy =
        binding1.UseDefaultWebProxy;

    BindingElementCollection bindingElements =
            binding1.CreateBindingElements();

        // Set WSHttpBinding binding property values
        binding1.Name = "Binding1";
        binding1.HostNameComparisonMode =
           HostNameComparisonMode.StrongWildcard;
        binding1.Security.Mode = SecurityMode.Message;
        binding1.ReliableSession.Enabled = false;
        binding1.TransactionFlow = false;
       // binding1.Security.Message.DefaultProtectionLevel = System.Net.Security.ProtectionLevel.EncryptAndSign;

        // Enumerate properties of the binding1.
        Console.WriteLine("WSHttpBinding binding1 properties:");
        Console.WriteLine("      - name:\t\t\t{0}", binding1.Name);
        Console.WriteLine("      - hostname comparison:\t{0}", binding1.HostNameComparisonMode);
        Console.WriteLine("      - security mode:\t\t{0}", binding1.Security.Mode);
        Console.WriteLine("      - RM enabled:\t\t{0}", binding1.ReliableSession.Enabled);
        Console.WriteLine("      - transaction flow:\t{0}", binding1.TransactionFlow);
        //Console.WriteLine("      - message security:\t{0}", binding1.Security.Message.DefaultProtectionLevel);
        Console.WriteLine("      - transport scheme:\t{0}", binding1.Scheme);
        Console.WriteLine("      - max message size:\t{0}", binding1.MaxReceivedMessageSize);
        Console.WriteLine("      - default text encoding:\t{0}", binding1.TextEncoding);
        Console.WriteLine();

        // Create a WSFederationBinding with a message security mode
        // and with a reliable session enabled.
        WSFederationHttpBinding binding3 = new WSFederationHttpBinding(WSFederationHttpSecurityMode.Message, true);

        // Enumerate properties of the binding2.
        Console.WriteLine("WSFederationBinding binding3 properties:");
        Console.WriteLine("      - security mode:\t\t{0}", binding3.Security.Mode);
        Console.WriteLine("      - RM enabled:\t\t{0}", binding3.ReliableSession.Enabled);
        Console.WriteLine();
        Console.WriteLine("Press <ENTER> to terminate.");
        Console.ReadLine();
    }

static void SnippetReceiveSynchronously ()
{
    WSHttpBinding binding = new WSHttpBinding();
    IBindingRuntimePreferences s  =
                       binding.GetProperty<IBindingRuntimePreferences>
                       (new BindingParameterCollection());
    bool receiveSynchronously = s.ReceiveSynchronously;
}
}

Uwagi

Zapewnia WSHttpBindingBase kilka podstawowych funkcji powiązań używanych do konfigurowania bezpiecznych, niezawodnych i międzyoperacyjnych usług sieci Web, takich jak zaimplementowane przez WSHttpBinding kontrakty usług innych niż dwudupleksowe, a w szczególności w celu zapewnienia bezpieczeństwa i współdziałania WSFederationHttpBinding obsługującego protokół WS-Federation.

Domyślnie generuje stos czasu wykonywania, który używa WS-Security na potrzeby zabezpieczeń i uwierzytelniania komunikatów, HTTP na potrzeby dostarczania komunikatów i kodowania komunikatów TEKST/XML. Można go również skonfigurować do używania WS-ReliableMessaging pod kątem niezawodności.

Użycie WS-ReliableMessaging można skonfigurować przy użyciu opcjonalnego reliableSessionEnabled parametru.

Konstruktory

WSHttpBindingBase()	Inicjuje nowe wystąpienie klasy WSHttpBindingBase.
WSHttpBindingBase(Boolean)	Inicjuje WSHttpBindingBase nowe wystąpienie klasy z wartością wskazującą, czy włączono niezawodną sesję.

Właściwości

BypassProxyOnLocal	Pobiera lub ustawia wartość wskazującą, czy pominąć serwer proxy dla adresów lokalnych.
CloseTimeout	Pobiera lub ustawia interwał czasu podanego dla połączenia do zamknięcia, zanim transport zgłasza wyjątek. (Odziedziczone po Binding)
EnvelopeVersion	Pobiera wersję protokołu SOAP, która jest używana dla komunikatów przetwarzanych przez to powiązanie.
MaxBufferPoolSize	Pobiera lub ustawia maksymalną ilość pamięci przydzielonej w bajtach dla menedżera buforów, który zarządza buforami wymaganymi przez punkty końcowe przy użyciu tego powiązania.
MaxReceivedMessageSize	Pobiera lub ustawia maksymalny rozmiar w bajtach dla komunikatu, który może zostać przetworzony przez powiązanie.
MessageEncoding	Pobiera lub ustawia, czy program MTOM, czy tekst/XML jest używany do kodowania komunikatów 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 podany dla połączenia do otwarcia, zanim transport zgłosi wyjątek. (Odziedziczone po Binding)
ProxyAddress	Pobiera lub ustawia adres URI serwera proxy HTTP.
ReaderQuotas	Pobiera lub ustawia ograniczenia złożoności komunikatów PROTOKOŁU SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania.
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)
ReliableSession	Pobiera obiekt, który zapewnia wygodny dostęp do właściwości elementu powiązania niezawodnej sesji, który jest dostępny podczas korzystania z jednego z powiązań dostarczanych przez system.
Scheme	Pobiera schemat transportu identyfikatora URI dla kanałów i odbiorników skonfigurowanych za pomocą tego powiązania.
SendTimeout	Pobiera lub ustawia interwał czasu podany 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.
TransactionFlow	Pobiera lub ustawia wartość wskazującą, czy to powiązanie powinno obsługiwać przepływ operacji WS-Transactions.
UseDefaultWebProxy	Pobiera lub ustawia wartość wskazującą, czy używany jest automatycznie skonfigurowany serwer proxy HTTP systemu, jeśli jest dostępny.

Metody

BuildChannelFactory<TChannel>(BindingParameterCollection)	Tworzy stos fabryki kanałów 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łów na kliencie, który tworzy określony typ kanału i spełnia funkcje określone przez tablicę obiektów. (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łów na kliencie, który spełnia wymagania określone przez tablicę obiektów. (Odziedziczone po Binding)
CreateBindingElements()	Zwraca uporządkowaną kolekcję elementów powiązania zawartych w bieżącym powiązaniu.
CreateMessageSecurity()	Po zaimplementowaniu w klasie pochodnej zwraca wartość SecurityBindingElement z bieżącego powiązania.
GetProperty<T>(BindingParameterCollection)	Zwraca żądany obiekt typu z odpowiedniej warstwy w stosie powiązań. (Odziedziczone po Binding)
GetTransport()	Po zaimplementowaniu w klasie pochodnej zwraca element powiązania transportu z bieżącego powiązania.

Dotyczy