WSHttpBinding Osztály

Definíció

Névtér:

System.ServiceModel

Szerelvények:

System.ServiceModel.dll, System.ServiceModel.Http.dll

Csomagok:

System.ServiceModel.Http v10.0.652802, System.ServiceModel.Primitives v10.0.652802

Forrás:

WSHttpBinding.cs

Olyan interoperábilis kötést jelöl, amely támogatja az elosztott tranzakciókat és a biztonságos, megbízható munkameneteket.

public ref class WSHttpBinding : System::ServiceModel::WSHttpBindingBase

public class WSHttpBinding : System.ServiceModel.WSHttpBindingBase

type WSHttpBinding = class
    inherit WSHttpBindingBase

Public Class WSHttpBinding
Inherits WSHttpBindingBase

Öröklődés

Object

Binding

WSHttpBindingBase

WSHttpBinding

Származtatott

System.ServiceModel.Federation.WSFederationHttpBinding

System.ServiceModel.WS2007HttpBinding

System.ServiceModel.WSHttpContextBinding

Példák

Az alábbi mintakód bemutatja az WSHttpBinding osztály használatát.

using System;
using System.ServiceModel;
using System.Collections.Generic;
using System.IdentityModel.Tokens;
using System.Security.Cryptography.X509Certificates;
using System.ServiceModel.Channels;
using System.ServiceModel.Security;
using System.ServiceModel.Security.Tokens;
using System.Security.Permissions;

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

public sealed class CustomBindingCreator
{

    public static void snippetSecurity()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        WSHttpSecurity whSecurity = wsHttpBinding.Security;
    }

    public static void snippetCreateBindingElements()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        BindingElementCollection beCollection = wsHttpBinding.CreateBindingElements();
    }

    private void snippetCreateMessageSecurity()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        // SecurityBindingElement sbe = wsHttpBinding
    }

    public static void snippetGetTransport()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        //		TransportBindingElement tbElement = wsHttpBinding.GetTransport();
    }

    public static void snippetAllowCookies()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        wsHttpBinding.AllowCookies = true;
    }

    public static Binding GetBinding()
    {
        // securityMode is Message
        // reliableSessionEnabled is true
        WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message, true);
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;

        WSHttpSecurity security = binding.Security;
        return binding;
    }

    public static Binding GetBinding2()
    {

        // The security mode is set to Message.
        WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message);
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;
        return binding;
    }

    // This method creates a WSFederationHttpBinding.
    public static WSFederationHttpBinding CreateWSFederationHttpBinding()
    {
        // Create an instance of the WSFederationHttpBinding
        WSFederationHttpBinding b = new WSFederationHttpBinding();

        // Set the security mode to Message
        b.Security.Mode = WSFederationHttpSecurityMode.Message;

        // Set the Algorithm Suite to Basic256Rsa15
        b.Security.Message.AlgorithmSuite = SecurityAlgorithmSuite.Basic256Rsa15;

        // Set NegotiateServiceCredential to true
        b.Security.Message.NegotiateServiceCredential = true;

        // Set IssuedKeyType to Symmetric
        b.Security.Message.IssuedKeyType = SecurityKeyType.SymmetricKey;

        // Set IssuedTokenType to SAML 1.1
        b.Security.Message.IssuedTokenType = "http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#samlv1.1";

        // Extract the STS certificate from the certificate store
        X509Store store = new X509Store(StoreName.TrustedPeople, StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly);
        X509Certificate2Collection certs = store.Certificates.Find(X509FindType.FindByThumbprint, "cd 54 88 85 0d 63 db ac 92 59 05 af ce b8 b1 de c3 67 9e 3f", false);
        store.Close();

        // Create an EndpointIdentity from the STS certificate
        EndpointIdentity identity = EndpointIdentity.CreateX509CertificateIdentity(certs[0]);

        // Set the IssuerAddress using the address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerAddress = new EndpointAddress(new Uri("http://localhost:8000/sts/x509"), identity);

        // Set the IssuerBinding to a WSHttpBinding loaded from config
        b.Security.Message.IssuerBinding = new WSHttpBinding("Issuer");

        // Set the IssuerMetadataAddress using the metadata address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerMetadataAddress = new EndpointAddress(new Uri("http://localhost:8001/sts/mex"), identity);

        // Create a ClaimTypeRequirement
        ClaimTypeRequirement ctr = new ClaimTypeRequirement("http://example.org/claim/c1", false);

        // Add the ClaimTypeRequirement to ClaimTypeRequirements
        b.Security.Message.ClaimTypeRequirements.Add(ctr);

        // Return the created binding
        return b;
    }
}

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

    // Host the service within this EXE console application.
    public static void Main()
    {
        // Create a WSHttpBinding and set its property values.
        WSHttpBinding binding = new WSHttpBinding();
        binding.Name = "binding1";
        binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;
        binding.Security.Mode = SecurityMode.Message;
        binding.ReliableSession.Enabled = false;
        binding.TransactionFlow = false;
        //Specify a base address for the service endpoint.
        Uri baseAddress = new Uri(@"http://localhost:8000/servicemodelsamples/service");
        // Create a ServiceHost for the CalculatorService type
        // and provide it with a base address.
        ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);
        serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, baseAddress);
        // 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 ServiceHost to shutdown the service.
        serviceHost.Close();
    }
}

Imports System.ServiceModel
Imports System.Collections.Generic
Imports System.IdentityModel.Tokens
Imports System.Security.Cryptography.X509Certificates
Imports System.ServiceModel.Channels
Imports System.ServiceModel.Security
Imports System.ServiceModel.Security.Tokens
Imports System.Security.Permissions

' 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

Public NotInheritable Class CustomBindingCreator

    Public Shared Sub snippetSecurity()
        Dim wsHttpBinding As New WSHttpBinding()
        Dim whSecurity As WSHttpSecurity = wsHttpBinding.Security
    End Sub


    Public Shared Sub snippetCreateBindingElements()
        Dim wsHttpBinding As New WSHttpBinding()
        Dim beCollection As BindingElementCollection = wsHttpBinding.CreateBindingElements()
    End Sub


    Private Sub snippetCreateMessageSecurity()
        Dim wsHttpBinding As New WSHttpBinding()
    End Sub

    Public Shared Sub snippetGetTransport()
        Dim wsHttpBinding As New WSHttpBinding()
    End Sub

    Public Shared Sub snippetAllowCookies()
        Dim wsHttpBinding As New WSHttpBinding()
        wsHttpBinding.AllowCookies = True
    End Sub

    Public Shared Function GetBinding() As Binding
        ' securityMode is Message
        ' reliableSessionEnabled is true
        Dim binding As New WSHttpBinding(SecurityMode.Message, True)
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows

        Dim security As WSHttpSecurity = binding.Security
        Return binding

    End Function

    Public Shared Function GetBinding2() As Binding

        ' The security mode is set to Message.
        Dim binding As New WSHttpBinding(SecurityMode.Message)
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows
        Return binding

    End Function

    ' This method creates a WSFederationHttpBinding.
    Public Shared Function CreateWSFederationHttpBinding() As WSFederationHttpBinding
        ' Create an instance of the WSFederationHttpBinding
        Dim b As New WSFederationHttpBinding()

        ' Set the security mode to Message
        b.Security.Mode = WSFederationHttpSecurityMode.Message

        ' Set the Algorithm Suite to Basic256Rsa15
        b.Security.Message.AlgorithmSuite = SecurityAlgorithmSuite.Basic256Rsa15

        ' Set NegotiateServiceCredential to true
        b.Security.Message.NegotiateServiceCredential = True

        ' Set IssuedKeyType to Symmetric
        b.Security.Message.IssuedKeyType = SecurityKeyType.SymmetricKey

        ' Set IssuedTokenType to SAML 1.1
        b.Security.Message.IssuedTokenType = "http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#samlv1.1"

        ' Extract the STS certificate from the certificate store
        Dim store As New X509Store(StoreName.TrustedPeople, StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadOnly)
        Dim certs As X509Certificate2Collection = store.Certificates.Find(X509FindType.FindByThumbprint, "cd 54 88 85 0d 63 db ac 92 59 05 af ce b8 b1 de c3 67 9e 3f", False)
        store.Close()

        ' Create an EndpointIdentity from the STS certificate
        Dim identity As EndpointIdentity = EndpointIdentity.CreateX509CertificateIdentity(certs(0))

        ' Set the IssuerAddress using the address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerAddress = New EndpointAddress(New Uri("http://localhost:8000/sts/x509"), identity)

        ' Set the IssuerBinding to a WSHttpBinding loaded from config
        b.Security.Message.IssuerBinding = New WSHttpBinding("Issuer")

        ' Set the IssuerMetadataAddress using the metadata address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerMetadataAddress = New EndpointAddress(New Uri("http://localhost:8001/sts/mex"), identity)

        ' Create a ClaimTypeRequirement
        Dim ctr As New ClaimTypeRequirement("http://example.org/claim/c1", False)

        ' Add the ClaimTypeRequirement to ClaimTypeRequirements
        b.Security.Message.ClaimTypeRequirements.Add(ctr)

        ' Return the created binding
        Return b
    End Function

End Class

' 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


    ' Host the service within this EXE console application. 
    Public Shared Sub Main()
        ' Create a WSHttpBinding and set its property values. 
        Dim binding As New WSHttpBinding()
        With binding
            .Name = "binding1"
            .HostNameComparisonMode = HostNameComparisonMode.StrongWildcard
            .Security.Mode = SecurityMode.Message
            .ReliableSession.Enabled = False
            .TransactionFlow = False
        End With
        
        'Specify a base address for the service endpoint. 
        Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")
        ' Create a ServiceHost for the CalculatorService type 
        ' and provide it with a base address. 
        Dim serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
        serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, baseAddress)
        ' 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 ServiceHost to shutdown the service. 
        serviceHost.Close()
    End Sub
End Class

Megjegyzések

Ez WSHttpBinding hasonló a BasicHttpBinding webszolgáltatáshoz, de több webszolgáltatást is biztosít. A HTTP-átvitelt használja, és az üzenetbiztonságot is biztosítja, de BasicHttpBindingtranzakciókat, megbízható üzenetküldést és WS-címzést is biztosít, amelyek alapértelmezés szerint engedélyezve vagy egyetlen vezérlőbeállítással érhetők el.

Konstruktorok

Name	Description
WSHttpBinding()	Inicializálja a WSHttpBinding osztály új példányát.
WSHttpBinding(SecurityMode, Boolean)	Inicializálja az osztály új példányát a WSHttpBinding kötés által használt biztonsági típussal, és egy olyan értékkel, amely jelzi, hogy engedélyezve van-e egy megbízható munkamenet.
WSHttpBinding(SecurityMode)	Inicializálja az osztály új példányát a WSHttpBinding kötés által használt megadott biztonsági típussal.

Tulajdonságok

Name	Description
AllowCookies	Lekéri vagy beállít egy értéket, amely jelzi, hogy a WCF-ügyfél automatikusan tárolja és újra elküldi-e az egyetlen webszolgáltatás által küldött cookie-kat.
BypassProxyOnLocal	Lekéri vagy beállít egy értéket, amely jelzi, hogy a helyi címek proxykiszolgálójának megkerülése szükséges-e. (Öröklődés forrása WSHttpBindingBase)
CloseTimeout	Lekéri vagy beállítja a kapcsolat lezárásához megadott időintervallumot, mielőtt az átvitel kivételt eredményezne. (Öröklődés forrása Binding)
EnvelopeVersion	Lekéri a SOAP azon verzióját, amelyet a kötés által feldolgozott üzenetekhez használnak. (Öröklődés forrása WSHttpBindingBase)
MaxBufferPoolSize	Lekéri vagy beállítja a maximálisan lefoglalt memóriamennyiséget bájtban a kötést használó végpontok által igényelt puffereket kezelő pufferkezelő számára. (Öröklődés forrása WSHttpBindingBase)
MaxReceivedMessageSize	Lekéri vagy beállítja a maximális méretet bájtban a kötéssel feldolgozható üzenetekhez. (Öröklődés forrása WSHttpBindingBase)
MessageEncoding	Lekérdezi vagy beállítja, hogy az MTOM vagy a Text/XML használatával kódolja-e a SOAP-üzeneteket. (Öröklődés forrása WSHttpBindingBase)
MessageVersion	Lekéri a kötéssel konfigurált ügyfelek és szolgáltatások által használt üzenetverziót. (Öröklődés forrása Binding)
Name	Lekéri vagy beállítja a kötés nevét. (Öröklődés forrása Binding)
Namespace	Lekéri vagy beállítja a kötés XML-névterét. (Öröklődés forrása Binding)
OpenTimeout	Lekéri vagy beállítja a kapcsolat megnyitásához megadott időintervallumot, mielőtt az átvitel kivételt eredményezne. (Öröklődés forrása Binding)
ProxyAddress	Lekéri vagy beállítja a HTTP-proxy URI-címét. (Öröklődés forrása WSHttpBindingBase)
ReaderQuotas	Lekéri vagy beállítja a SOAP-üzenetek összetettségére vonatkozó korlátozásokat, amelyeket az ezzel a kötéssel konfigurált végpontok feldolgozhatnak. (Öröklődés forrása WSHttpBindingBase)
ReceiveTimeout	Lekéri vagy beállítja a kapcsolat inaktív állapotának időtartamát, amely alatt nem érkeznek alkalmazásüzenetek, mielőtt megszakadna. (Öröklődés forrása Binding)
ReliableSession	Olyan objektumot kap, amely kényelmes hozzáférést biztosít egy megbízható munkamenet-kötési elem tulajdonságaihoz, amelyek a rendszer által biztosított kötések egyikének használatakor érhetők el. (Öröklődés forrása WSHttpBindingBase)
Scheme	Lekéri az URI átviteli sémát a kötéssel konfigurált csatornákhoz és figyelőkhöz. (Öröklődés forrása WSHttpBindingBase)
Security	Lekéri a kötéshez használt biztonsági beállításokat.
SendTimeout	Lekéri vagy beállítja az írási művelethez megadott időintervallumot, mielőtt az átvitel kivételt eredményezne. (Öröklődés forrása Binding)
TextEncoding	Lekéri vagy beállítja az üzenet szövegéhez használt karakterkódolást. (Öröklődés forrása WSHttpBindingBase)
TransactionFlow	Lekéri vagy beállít egy értéket, amely jelzi, hogy ennek a kötésnek támogatnia kell-e a WS-Transactions folyamatait. (Öröklődés forrása WSHttpBindingBase)
UseDefaultWebProxy	Lekéri vagy beállít egy értéket, amely jelzi, hogy a rendszer automatikusan konfigurált HTTP-proxyját kell-e használni, ha van ilyen. (Öröklődés forrása WSHttpBindingBase)

Metódusok

Name	Description
BuildChannelFactory<TChannel>(BindingParameterCollection)	A channel factory vermet azon az ügyfélen hozza létre, amely egy adott típusú csatornát hoz létre, és amely megfelel a kötési paraméterek gyűjteményében megadott funkcióknak.
BuildChannelFactory<TChannel>(Object[])	A channel factory vermet azon az ügyfélen hozza létre, amely egy adott típusú csatornát hoz létre, és amely megfelel az objektumtömb által megadott funkcióknak. (Öröklődés forrása Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Olyan értéket ad vissza, amely jelzi, hogy az aktuális kötés képes-e csatorna-előállító vermet létrehozni az ügyfélen, amely megfelel a megadott kötési paraméterek gyűjteményének. (Öröklődés forrása Binding)
CanBuildChannelFactory<TChannel>(Object[])	Olyan értéket ad vissza, amely jelzi, hogy az aktuális kötés képes-e olyan csatorna-előállító vermet létrehozni az ügyfélen, amely megfelel az objektumtömb által meghatározott követelményeknek. (Öröklődés forrása Binding)
CreateBindingElements()	Az aktuális kötésben található kötéselemek rendezett gyűjteményét adja vissza.
CreateMessageSecurity()	Az aktuális kötés biztonsági kötési elemét adja vissza.
GetProperty<T>(BindingParameterCollection)	A kötési verem megfelelő rétegéből kért beírt objektumot ad vissza, ha van ilyen. (Öröklődés forrása Binding)
GetTransport()	Az aktuális kötés átviteli kötési elemét adja vissza.