WSHttpBindingBase Třída

Reference

Definice

Obor názvů:: System.ServiceModel

Sestavení:: System.ServiceModel.Http.dll

Sestavení:: System.ServiceModel.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje základní třídu se členy společné pro a WSHttpBinding WSFederationHttpBinding.

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

public ref class WSHttpBindingBase abstract : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences

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

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

type WSHttpBindingBase = class
    inherit Binding

type WSHttpBindingBase = class
    inherit Binding
    interface IBindingRuntimePreferences

Public MustInherit Class WSHttpBindingBase
Inherits Binding

Public MustInherit Class WSHttpBindingBase
Inherits Binding
Implements IBindingRuntimePreferences

Dědičnost: Object

Binding
WSHttpBindingBase

Odvozené: System.ServiceModel.WSFederationHttpBinding

System.ServiceModel.WSHttpBinding

Implementuje: IBindingRuntimePreferences

Příklady

Následující příklad ukazuje, jak používat funkce poskytované WSHttpBindingBase třídou s odvozenými třídami WSHttpBinding a WSFederationHttpBinding.


// 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;
}
}


' Define a service contract for the calculator.
<ServiceContract()> _
Public Interface ICalculator
    <OperationContract(IsOneWay := False)> _
    Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract(IsOneWay := False)> _
    Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract(IsOneWay := False)> _
    Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract(IsOneWay := False)> _
    Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
End Interface

' Service class which implements the service contract.
Public Class CalculatorService
    Implements ICalculator
    Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add
        Dim result = n1 + n2
        Return result
    End Function

    Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract
        Dim result = n1 - n2
        Return result
    End Function

    Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply
        Dim result = n1 * n2
        Return result
    End Function

    Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide
        Dim result = n1 / n2
        Return result
    End Function

    ' Create and configure bindings within this EXE console application.
    Public Shared Sub Main()
        ' Create a WSHttpBinding
        Dim binding1 As New WSHttpBinding()

    binding1.BypassProxyOnLocal = True

    Dim envelopeVersion As EnvelopeVersion = binding1.EnvelopeVersion

    Dim hostnameComparisonMode As HostNameComparisonMode = binding1.HostNameComparisonMode

        Dim maxBufferPoolSize = binding1.MaxBufferPoolSize


        Dim maxReceivedMessageSize = binding1.MaxReceivedMessageSize

    Dim messageEncoding As WSMessageEncoding = binding1.MessageEncoding

    Dim proxyAddress As Uri = binding1.ProxyAddress

    Dim readerQuotas As XmlDictionaryReaderQuotas = binding1.ReaderQuotas

    Dim reliableSession As OptionalReliableSession = binding1.ReliableSession

        Dim scheme = binding1.Scheme

        Dim textEncoding = binding1.TextEncoding

        Dim transactionFlow = binding1.TransactionFlow

        Dim useDefaultWebProxy = binding1.UseDefaultWebProxy

    Dim bindingElements As BindingElementCollection = 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:" & Constants.vbTab + Constants.vbTab + Constants.vbTab & "{0}", binding1.Name)
        Console.WriteLine("      - hostname comparison:" & Constants.vbTab & "{0}", binding1.HostNameComparisonMode)
        Console.WriteLine("      - security mode:" & Constants.vbTab + Constants.vbTab & "{0}", binding1.Security.Mode)
        Console.WriteLine("      - RM enabled:" & Constants.vbTab + Constants.vbTab & "{0}", binding1.ReliableSession.Enabled)
        Console.WriteLine("      - transaction flow:" & Constants.vbTab & "{0}", binding1.TransactionFlow)
        'Console.WriteLine("      - message security:\t{0}", binding1.Security.Message.DefaultProtectionLevel);
        Console.WriteLine("      - transport scheme:" & Constants.vbTab & "{0}", binding1.Scheme)
        Console.WriteLine("      - max message size:" & Constants.vbTab & "{0}", binding1.MaxReceivedMessageSize)
        Console.WriteLine("      - default text encoding:" & Constants.vbTab & "{0}", binding1.TextEncoding)
        Console.WriteLine()

        ' Create a WSFederationBinding with a message security mode
        ' and with a reliable session enabled.
        Dim binding3 As New WSFederationHttpBinding(WSFederationHttpSecurityMode.Message, True)

        ' Enumerate properties of the binding2.
        Console.WriteLine("WSFederationBinding binding3 properties:")
        Console.WriteLine("      - security mode:" & Constants.vbTab + Constants.vbTab & "{0}", binding3.Security.Mode)
        Console.WriteLine("      - RM enabled:" & Constants.vbTab + Constants.vbTab & "{0}", binding3.ReliableSession.Enabled)
        Console.WriteLine()
        Console.WriteLine("Press <ENTER> to terminate.")
        Console.ReadLine()

    End Sub

Private Shared Sub SnippetReceiveSynchronously()
    Dim binding As New WSHttpBinding()
    Dim s As IBindingRuntimePreferences = binding.GetProperty(Of IBindingRuntimePreferences) (New BindingParameterCollection())
        Dim receiveSynchronously = s.ReceiveSynchronously

End Sub

End Class

Poznámky

Poskytuje WSHttpBindingBase některé základní funkce pro vazby používané ke konfiguraci zabezpečených, spolehlivých a interoperabilních webových služeb, jako jsou ty, které implementují WSHttpBinding pro ne duplexní kontrakty služeb, a zejména pro zabezpečené a interoperabilní WSFederationHttpBinding , které podporují protokol WS-Federation.

Ve výchozím nastavení generuje zásobník za běhu, který používá WS-Security pro zabezpečení a ověřování zpráv, HTTP pro doručování zpráv a kódování zpráv text/XML. Dá se nakonfigurovat tak, aby také používal WS-ReliableMessaging pro spolehlivost.

Použití WS-ReliableMessaging je možné konfigurovat pomocí volitelného reliableSessionEnabled parametru.

Konstruktory

WSHttpBindingBase()	Inicializuje novou instanci WSHttpBindingBase třídy.
WSHttpBindingBase(Boolean)	Inicializuje novou instanci WSHttpBindingBase třídy s hodnotou, která označuje, zda je povolena spolehlivá relace.

Vlastnosti

BypassProxyOnLocal	Získá nebo nastaví hodnotu, která označuje, zda se má obejít proxy server pro místní adresy.
CloseTimeout	Získá nebo nastaví interval času, který je k dispozici pro připojení zavřít před vyvolání výjimky. (Zděděno od Binding)
EnvelopeVersion	Získá verzi protokolu SOAP, která se používá pro zprávy, které jsou zpracovány touto vazbou.
HostNameComparisonMode	Získá nebo nastaví hodnotu, která označuje, zda se název hostitele používá k dosažení služby při porovnávání identifikátoru URI.
MaxBufferPoolSize	Získá nebo nastaví maximální množství paměti přidělené v bajtech pro správce vyrovnávací paměti, který spravuje vyrovnávací paměti vyžadované koncovými body pomocí této vazby.
MaxReceivedMessageSize	Získá nebo nastaví maximální velikost v bajtech pro zprávu, která může být zpracována vazbou.
MessageEncoding	Získá nebo nastaví, zda MTOM nebo Text/XML se používá ke kódování zpráv SOAP.
MessageVersion	Získá verzi zprávy, kterou klienti a služby konfigurují s vazbou. (Zděděno od Binding)
Name	Získá nebo nastaví název vazby. (Zděděno od Binding)
Namespace	Získá nebo nastaví obor názvů XML vazby. (Zděděno od Binding)
OpenTimeout	Získá nebo nastaví interval času, který je k dispozici pro připojení, aby se otevřelo před vyvolání výjimky přenosu. (Zděděno od Binding)
ProxyAddress	Získá nebo nastaví adresu URI proxy serveru HTTP.
ReaderQuotas	Získá nebo nastaví omezení složitosti zpráv SOAP, které lze zpracovat koncovými body nakonfigurovanými touto vazbou.
ReceiveTimeout	Získá nebo nastaví interval doby, po kterou může připojení zůstat neaktivní, během kterého nebudou přijaty žádné zprávy aplikace, než se odstraní. (Zděděno od Binding)
ReliableSession	Získá objekt, který poskytuje pohodlný přístup k vlastnostem spolehlivého prvku vazby relace, které jsou k dispozici při použití jedné ze systémových vazeb poskytnuté vazby.
Scheme	Získá schéma přenosu identifikátoru URI pro kanály a naslouchací procesy, které jsou nakonfigurovány s touto vazbou.
SendTimeout	Získá nebo nastaví interval času, který je k dispozici pro operaci zápisu dokončit před přenos vyvolá výjimku. (Zděděno od Binding)
TextEncoding	Získá nebo nastaví kódování znaků, které se používá pro text zprávy.
TransactionFlow	Získá nebo nastaví hodnotu, která označuje, zda má tato vazba podporovat tok WS-Transactions.
UseDefaultWebProxy	Získá nebo nastaví hodnotu, která označuje, zda se má použít automaticky nakonfigurovaný proxy server HTTP systému, pokud je k dispozici.

Metody

BuildChannelFactory<TChannel>(BindingParameterCollection)	Sestaví zásobník továrny kanálu na klientovi, který vytvoří zadaný typ kanálu a který splňuje funkce určené kolekcí parametrů vazby. (Zděděno od Binding)
BuildChannelFactory<TChannel>(Object[])	Vytvoří zásobník objektu pro vytváření kanálů na klientovi, který vytvoří zadaný typ kanálu a který vyhovuje funkcím určeným polem objektů. (Zděděno od Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje funkce určené kolekcí parametrů vazby. (Zděděno od Binding)
BuildChannelListener<TChannel>(Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník objektu pro vytváření kanálů na klientovi, který splňuje kolekci zadaných parametrů vazby. (Zděděno od Binding)
CanBuildChannelFactory<TChannel>(Object[])	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník objektu pro vytváření kanálů na klientovi, který splňuje požadavky určené polem objektů. (Zděděno od Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník naslouchacího procesu kanálu ve službě, která splňuje kolekci zadaných parametrů vazby. (Zděděno od Binding)
CanBuildChannelListener<TChannel>(Object[])	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník naslouchacího procesu kanálu ve službě, která splňuje kritéria zadaná v poli objektů. (Zděděno od Binding)
CreateBindingElements()	Vrátí uspořádanou kolekci vazeb prvků obsažených v aktuální vazbě.
CreateMessageSecurity()	Při implementaci v odvozené třídě vrátí z aktuální vazby SecurityBindingElement .
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetProperty<T>(BindingParameterCollection)	Vrátí požadovaný typ objektu z příslušné vrstvy v zásobníku vazeb. (Zděděno od Binding)
GetTransport()	Při implementaci v odvozené třídě vrátí transport binding element z aktuální vazby.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ShouldSerializeName()	Vrátí, zda má být název vazby serializován. (Zděděno od Binding)
ShouldSerializeNamespace()	Vrátí, zda má být obor názvů vazby serializován. (Zděděno od Binding)
ShouldSerializeReaderQuotas()	Vrátí hodnotu, která určuje, zda se ReaderQuotas vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeReliableSession()	Vrátí hodnotu, která určuje, zda se ReliableSession vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeTextEncoding()	Vrátí hodnotu, která určuje, zda se TextEncoding vlastnost změnila z výchozí hodnoty a měla by být serializována.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IBindingRuntimePreferences.ReceiveSynchronously

Získá hodnotu, která označuje, zda příchozí požadavky jsou zpracovávány synchronně nebo asynchronně.

Platí pro

Sdílet prostřednictvím