HttpTransportBindingElement HttpTransportBindingElement HttpTransportBindingElement HttpTransportBindingElement Class

Definition

Stellt das Bindungselement dar, mit dem eine HTTP-Übertragung zum Senden von Nachrichten angegeben wird. Represents the binding element used to specify an HTTP transport for transmitting messages.

public ref class HttpTransportBindingElement : System::ServiceModel::Channels::TransportBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public class HttpTransportBindingElement : System.ServiceModel.Channels.TransportBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type HttpTransportBindingElement = class
    inherit TransportBindingElement
    interface IPolicyExportExtension
    interface IWsdlExportExtension
Public Class HttpTransportBindingElement
Inherits TransportBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
Vererbung
Abgeleitet
Implementiert

Beispiele

Im folgenden Code wird die zwingende Verwendung von HttpTransportBindingElement veranschaulicht.The following code shows how to imperatively use the HttpTransportBindingElement.

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    // Create a custom binding that contains two binding elements.
    ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();
    reliableSession.Ordered = true;

    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;

    CustomBinding binding = new CustomBinding(reliableSession, httpTransport);

    // Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");

    // Add a MEX endpoint.
    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
    smb.HttpGetEnabled = true;
    smb.HttpGetUrl = new Uri("http://localhost:8001/servicemodelsamples");
    serviceHost.Description.Behaviors.Add(smb);
  
    // 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();
}
Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")

' Create a ServiceHost for the CalculatorService type and provide the base address.
Using serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
	' Create a custom binding that contains two binding elements.
	Dim reliableSession As New ReliableSessionBindingElement()
	reliableSession.Ordered = True

	Dim httpTransport As New HttpTransportBindingElement()
	httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous
	httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard

	Dim binding As New CustomBinding(reliableSession, httpTransport)

	' Add an endpoint using that binding.
	serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, "")

	' Add a MEX endpoint.
	Dim smb As New ServiceMetadataBehavior()
	smb.HttpGetEnabled = True
	smb.HttpGetUrl = New Uri("http://localhost:8001/servicemodelsamples")
	serviceHost.Description.Behaviors.Add(smb)

	' 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()
End Using

HttpTransportBindingElement kann auch in einer Konfigurationsdatei wie in der folgenden Konfiguration abgebildet verwendet werden.HttpTransportBindingElement can also be used in a configuration file as shown in the following configuration.

<bindings>  
  <customBinding>  
    <binding name="Binding1">  
      <reliableSession acknowledgementInterval="00:00:00.2000000" enableFlowControl="true"  
                        maxTransferWindowSize="32" inactivityTimeout="00:10:00" maxPendingChannels="128"  
                        maxRetryCount="8" ordered="true" />  
      <security mode="None"/>  
      <httpTransport authenticationScheme="Anonymous" bypassProxyOnLocal="false"  
                    hostNameComparisonMode="StrongWildcard"   
                    proxyAuthenticationScheme="Anonymous" realm=""   
                    useDefaultWebProxy="true" />  
    </binding>  
  </customBinding>  
</bindings>  

Hinweise

Die HttpTransportBindingElement-Klasse stellt den Startpunkt für das Erstellen einer benutzerdefinierten Bindung dar, die das HTTP-Transportprotokoll implementiert.The HttpTransportBindingElement class is the starting point for creating a custom binding that implements the HTTP transport protocol. HTTP stellt die primäre Übertragungsweise für den Datenaustausch dar.HTTP is the primary transport used for interoperability purposes. Dieser Transport wird von Windows Communication Foundation (WCF) um sicherzustellen, dass Interoperabilität mit anderen nicht - WCF-Dienste unterstützt.This transport is supported by Windows Communication Foundation (WCF) to ensure interoperability with other non-WCF Web services stacks.

Das WCF-Dienstmodell verwendet diese Klasse Factoryobjekte zu erstellen, implementieren die IChannelFactory und IChannelListener Schnittstellen.The WCF service model uses this class to create factory objects that implement the IChannelFactory and IChannelListener interfaces. Diese Factoryobjekte erstellen wiederum die Kanäle und Listener, mit denen SOAP-Nachrichten über das HTTP-Protokoll übertragen werden.These factory objects, in turn, create the channels and listeners that transmit SOAP messages using the HTTP protocol.

Die von dieser Klasse erstellten Factorys können durch Festlegen der Eigenschaften konfiguriert werden, wie z. B. AuthenticationScheme, HostNameComparisonMode und MaxBufferSize.You configure the factories that this class creates by setting its properties, such as AuthenticationScheme, HostNameComparisonMode, and MaxBufferSize.

Sie können auch Eigenschaften für die Basisklasse TransportBindingElement festlegen, wie z. B. ManualAddressing, MaxReceivedMessageSize und MaxBufferPoolSize.You can also set properties on the base class, TransportBindingElement, such as ManualAddressing, MaxReceivedMessageSize, and MaxBufferPoolSize. Eine vollständige Liste der Eigenschaften finden Sie unter TransportBindingElement.For a complete list of properties, see TransportBindingElement.

Konstruktoren

HttpTransportBindingElement() HttpTransportBindingElement() HttpTransportBindingElement() HttpTransportBindingElement()

Initialisiert eine neue Instanz der HttpTransportBindingElement-Klasse. Initializes a new instance of the HttpTransportBindingElement class.

HttpTransportBindingElement(HttpTransportBindingElement) HttpTransportBindingElement(HttpTransportBindingElement) HttpTransportBindingElement(HttpTransportBindingElement) HttpTransportBindingElement(HttpTransportBindingElement)

Initialisiert unter Verwendung eines anderen Bindungselements eine neue Instanz der HttpTransportBindingElement-Klasse. Initializes a new instance of the HttpTransportBindingElement class using another binding element.

Eigenschaften

AllowCookies AllowCookies AllowCookies AllowCookies

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Client Cookies akzeptiert und bei zukünftigen Anfragen weiterleitet. Gets or sets a value that indicates whether the client accepts cookies and propagates them on future requests.

AuthenticationScheme AuthenticationScheme AuthenticationScheme AuthenticationScheme

Ruft das Authentifizierungsschema ab oder legt es fest, das verwendet wird, um Clientanforderungen zu authentifizieren, die von einem HTTP-Listener verarbeitet werden. Gets or sets the authentication scheme used to authenticate client requests being processed by an HTTP listener.

BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Proxys für lokale Adressen ignoriert werden. Gets or sets a value that indicates whether proxies are ignored for local addresses.

DecompressionEnabled DecompressionEnabled DecompressionEnabled DecompressionEnabled

Ruft ab oder legt fest, ob der Prozess zum Zurückgeben von komprimierten Meldungsdaten in ihrer ursprünglichen Größe und ihrem ursprünglichen Format aktiviert ist. Gets or sets whether the process for returning compressed message data to its original size and format is enabled.

ExtendedProtectionPolicy ExtendedProtectionPolicy ExtendedProtectionPolicy ExtendedProtectionPolicy

Ruft den Wert der erweiterten Sicherheitsrichtlinie ab, der vom Server verwendet wird, um eingehende Clientverbindungen zu überprüfen, oder legt ihn fest. Gets or sets the value of the extended security policy used by the server to validate incoming client connections.

HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Hostname zum Erreichen des Diensts bei übereinstimmendem URI verwendet werden soll. Gets or sets a value that indicates whether the hostname is used to reach the service when matching on the URI.

KeepAliveEnabled KeepAliveEnabled KeepAliveEnabled KeepAliveEnabled

Ruft einen Wert ab, der angibt, ob eine permanente Verbindung mit einem Dienstendpunkt hergestellt werden soll, oder legt diesen fest. Gets or sets a value that indicates whether to make a persistent connection to a service endpoint.

LegacyExtendedProtectionPolicy LegacyExtendedProtectionPolicy LegacyExtendedProtectionPolicy LegacyExtendedProtectionPolicy
ManualAddressing ManualAddressing ManualAddressing ManualAddressing

Ruft einen Wert ab, der angibt, ob eine manuelle Adressierung der Nachricht erforderlich ist, oder legt diesen fest. Gets or sets a value that indicates whether manual addressing of the message is required.

(Inherited from TransportBindingElement)
MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

Ruft die maximale Größe in Byte von Pufferpools ab, die vom Transport verwendet werden, oder legt diese fest. Gets or sets the maximum size, in bytes, of any buffer pools used by the transport.

(Inherited from TransportBindingElement)
MaxBufferSize MaxBufferSize MaxBufferSize MaxBufferSize

Ruft die maximale Größe des zu verwendenden Puffers ab oder legt diese fest. Gets or sets the maximum size of the buffer to use. Für gepufferte Nachrichten ist dieser Wert der Gleiche wie MaxReceivedMessageSize. For buffered messages this value is the same as MaxReceivedMessageSize. Für per Streaming übertragene Nachrichten sollte dieser Wert mindestens die maximale Größe der SOAP-Header aufweisen, die im gepufferten Modus gelesen werden müssen. For streamed messages, this value is the maximum size of the SOAP headers, which must be read in buffered mode.

MaxPendingAccepts MaxPendingAccepts MaxPendingAccepts MaxPendingAccepts

Ruft die maximale Anzahl an Verbindungen, die der Dienst gleichzeitig annehmen kann, ab oder legt sie fest. Gets or sets the maximum number of connections the service can accept simultaneously.

MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize

Ruft die maximal zulässige Meldungsgröße in Byte ab, die empfangen werden können, und legt diese fest. Gets and sets the maximum allowable message size, in bytes, that can be received.

(Inherited from TransportBindingElement)
MessageHandlerFactory MessageHandlerFactory MessageHandlerFactory MessageHandlerFactory

Ruft die HTTP-Transport Meldungshandler Factory ab oder legt diese fest. Gets or sets the Http transport message handler factory.

ProxyAddress ProxyAddress ProxyAddress ProxyAddress

Ruft einen URI ab oder legt ihn fest, der die Adresse des Proxys enthält, der für HTTP-Anforderungen verwendet werden soll. Gets or sets a URI that contains the address of the proxy to use for HTTP requests.

ProxyAuthenticationScheme ProxyAuthenticationScheme ProxyAuthenticationScheme ProxyAuthenticationScheme

Ruft das Authentifizierungsschema ab oder legt es fest, das verwendet wird, um Clientanforderungen zu authentifizieren, die von einem HTTP-Proxy verarbeitet werden. Gets or sets the authentication scheme used to authenticate client requests being processed by an HTTP proxy.

Realm Realm Realm Realm

Ruft den Authentifizierungsbereich ab oder legt ihn fest. Gets or sets the authentication realm.

RequestInitializationTimeout RequestInitializationTimeout RequestInitializationTimeout RequestInitializationTimeout

Übernimmt oder bestimmt den angeforderten Timeoutwert. Gets or sets the requested initialization time out.

Scheme Scheme Scheme Scheme

Ruft das URI-Schema für den Transport ab. Gets the URI scheme for the transport.

TransferMode TransferMode TransferMode TransferMode

Ruft den Übertragungsmodus ab oder legt ihn fest. Gets or sets the transfer mode.

UnsafeConnectionNtlmAuthentication UnsafeConnectionNtlmAuthentication UnsafeConnectionNtlmAuthentication UnsafeConnectionNtlmAuthentication

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Freigabe nicht sicherer Verbindungen auf dem Server aktiviert wird. Gets or sets a value that indicates whether Unsafe Connection Sharing is enabled on the server. Wenn aktiviert, wird NTLM-Authentifizierung einmal auf jeder TCP-Verbindung ausgeführt. If enabled, NTLM authentication is performed once on each TCP connection.

UseDefaultWebProxy UseDefaultWebProxy UseDefaultWebProxy UseDefaultWebProxy

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Proxyeinstellungen auf dem Computer anstatt der benutzerspezifischen Einstellungen verwendet werden sollen. Gets or sets a value that indicates whether the machine-wide proxy settings are used rather than the user specific settings.

WebSocketSettings WebSocketSettings WebSocketSettings WebSocketSettings

Ruft die Web-Socket-Konfiguration des Bindungselements ab oder legt diese fest. Gets or sets the web socket configuration of the binding element.

Methoden

BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext)

Erstellt eine Kanalfactory, mit der ein Kanal erstellt werden kann. Creates a channel factory that can be used to create a channel.

BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext)

Erstellt einen Kanallistener des angegebenen Typs. Creates a channel listener of the specified type.

CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext)

Bestimmt, ob eine Kanalfactory des angegebenen Typs erstellt werden kann. Determines whether a channel factory of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext)

Bestimmt, ob ein Kanallistener des angegebenen Typs erstellt werden kann. Determines whether a channel listener of the specified type can be built.

Clone() Clone() Clone() Clone()

Erstellt eine neue Instanz, bei der es sich um eine Kopie des aktuellen Bindungselements handelt. Creates a new instance that is a copy of the current binding element.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion. Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext)

Ruft eine Eigenschaft aus dem angegebenen BindingContext ab. Gets a property from the specified BindingContext.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab. Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object. Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeExtendedProtectionPolicy() ShouldSerializeExtendedProtectionPolicy() ShouldSerializeExtendedProtectionPolicy() ShouldSerializeExtendedProtectionPolicy()

Gibt einen Wert zurück, der angibt, dass es nicht möglich ist, die erweiterte Schutzrichtlinie in XAML zu serialisieren. Returns a valueindicating that it is not possible to XAML serialize the extended protection policy.

ShouldSerializeMessageHandlerFactory() ShouldSerializeMessageHandlerFactory() ShouldSerializeMessageHandlerFactory() ShouldSerializeMessageHandlerFactory()

Bestimmt, ob die Meldungshandler-Factory serialisiert werden soll. Determines whether the message handler factory should be serialized.

ShouldSerializeWebSocketSettings() ShouldSerializeWebSocketSettings() ShouldSerializeWebSocketSettings() ShouldSerializeWebSocketSettings()

Bestimmt, ob die Internet-Socket-Einstellungen serialisiert werden sollen. Determines whether the web socket settings should be serialized.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. Returns a string that represents the current object.

(Inherited from Object)
UpdateAuthenticationSchemes(BindingContext) UpdateAuthenticationSchemes(BindingContext) UpdateAuthenticationSchemes(BindingContext) UpdateAuthenticationSchemes(BindingContext)

Aktualisiert die Übertragungsauthentifizierungsschemas, die den Bindungskontext enthalten. Updates the transport authentication schemes that contains the binding context.

Explizite Schnittstellenimplementierungen

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Exportiert eine benutzerdefinierte Richtlinienassertion über Bindungen. Exports a custom policy assertion about bindings.

IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Schreibt benutzerdefinierte WSDL (Web Services Description Language)-Elemente in für einen Vertrag generierte WSDL. Writes custom Web Services Description Language (WSDL) elements into the generated WSDL for a contract.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Schreibt benutzerdefinierte WSDL (Web Services Description Language)-Elemente in die generierte WSDL für einen Endpunkt. Writes custom Web Services Description Language (WSDL) elements into the generated WSDL for an endpoint.

Gilt für: