이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
내보내기(0) 인쇄
모두 확장

WebHttpRelayBinding 클래스

SOAP 메시지 대신 HTTP 요청을 통해 표시되는 웹 서비스의 끝점을 구성하는 데 사용되는 바인딩입니다.

System.Object
  System.ServiceModel.Channels.Binding
    Microsoft.ServiceBus.WebHttpRelayBinding

네임스페이스:  Microsoft.ServiceBus
어셈블리:  Microsoft.ServiceBus(Microsoft.ServiceBus.dll)

public class WebHttpRelayBinding : Binding, 
	IBindingRuntimePreferences

WebHttpRelayBinding 유형에서 다음 멤버를 표시합니다.

  이름설명
공용 메서드WebHttpRelayBinding()WebHttpRelayBinding 클래스의 새 인스턴스를 초기화합니다.
공용 메서드WebHttpRelayBinding(String)지정된 구성 이름을 사용하여 WebHttpRelayBinding 클래스의 새 인스턴스를 초기화합니다.
공용 메서드WebHttpRelayBinding(EndToEndWebHttpSecurityMode, RelayClientAuthenticationType)지정된 보안 및 릴레이 클라이언트 인증 유형을 사용하여 WebHttpRelayBinding 클래스의 새 인스턴스를 초기화합니다.
맨 위로 이동

  이름설명
공용 속성AllowCookiesWebHttpRelayBinding을 통해 보내는 메시지에 쿠키가 허용되는지 여부를 지정하는 값을 가져오거나 설정합니다.
공용 속성CloseTimeout (Binding에서 상속됨)
공용 속성ContentTypeMapper콘텐츠 형식 매퍼를 가져오거나 설정합니다.
공용 속성EnvelopeVersionSOAP 봉투 버전을 가져옵니다.
공용 속성HostNameComparisonMode호스트 이름에 사용되는 비교 모드를 가져오거나 설정합니다.
공용 속성IsDynamic릴레이 바인딩이 동적인지 여부를 가져오거나 설정합니다.
공용 속성MaxBufferPoolSize전송에 사용되는 최대 버퍼 풀 크기를 가져오거나 설정합니다.
공용 속성MaxBufferSize전송에서 지원되는 최대 버퍼 크기를 가져오거나 설정합니다.
공용 속성MaxReceivedMessageSize수신할 수 있는 허용 가능한 최대 메시지 크기를 가져오거나 설정합니다.
공용 속성MessageVersion (Binding에서 상속됨)
공용 속성Name (Binding에서 상속됨)
공용 속성Namespace (Binding에서 상속됨)
공용 속성OpenTimeout (Binding에서 상속됨)
공용 속성ProxyAddressHTTP 요청에 사용할 프록시 주소가 포함된 URI를 가져오거나 설정합니다.
공용 속성ReaderQuotas처리되는 메시지에 대한 xml 판독기 할당량을 가져오거나 설정합니다.
공용 속성ReceiveTimeout (Binding에서 상속됨)
공용 속성Scheme바인딩에 사용되는 끝점의 구성표를 가져옵니다. (Binding.Scheme을(를) 재정의함)
공용 속성Security현재 인스턴스에 대한 보안 설정을 가져옵니다.
공용 속성SendTimeout (Binding에서 상속됨)
공용 속성TransferMode전송 모드를 가져오거나 설정합니다.
공용 속성UseDefaultWebProxy사용자별 설정 대신 시스템 전체의 프록시 설정이 사용되는지 여부를 나타내는 값을 가져오거나 설정합니다.
공용 속성WriteEncoding메시지 텍스트 작성에 사용되는 문자 인코딩을 가져오거나 설정합니다.
맨 위로 이동

  이름설명
공용 메서드BuildChannelFactory<TChannel>(Object[]) (Binding에서 상속됨)
공용 메서드BuildChannelFactory<TChannel>(BindingParameterCollection) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Object[]) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(BindingParameterCollection) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Uri, Object[]) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Uri, BindingParameterCollection) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Uri, String, Object[]) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) (Binding에서 상속됨)
공용 메서드BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) (Binding에서 상속됨)
공용 메서드CanBuildChannelFactory<TChannel>(Object[]) (Binding에서 상속됨)
공용 메서드CanBuildChannelFactory<TChannel>(BindingParameterCollection) (Binding에서 상속됨)
공용 메서드CanBuildChannelListener<TChannel>(Object[]) (Binding에서 상속됨)
공용 메서드CanBuildChannelListener<TChannel>(BindingParameterCollection) (Binding에서 상속됨)
공용 메서드CreateBindingElements바인딩에 대한 바인딩 요소로 컬렉션을 만듭니다. (Binding.CreateBindingElements()을(를) 재정의함)
공용 메서드Equals (Object에서 상속됨)
보호된 메서드Finalize (Object에서 상속됨)
공용 메서드GetHashCode (Object에서 상속됨)
공용 메서드GetProperty<T> (Binding에서 상속됨)
공용 메서드GetType (Object에서 상속됨)
보호된 메서드MemberwiseClone (Object에서 상속됨)
공용 메서드ShouldSerializeName (Binding에서 상속됨)
공용 메서드ShouldSerializeNamespace (Binding에서 상속됨)
공용 메서드ToString (Object에서 상속됨)
맨 위로 이동

  이름설명
명시적 인터페이스 구현전용 속성IBindingRuntimePreferences.ReceiveSynchronously들어오는 요청을 동기적으로 처리하는지, 비동기적으로 처리하는지를 나타내는 값을 가져옵니다.
맨 위로 이동

The WebHttpRelayBinding is ideal for integrating simple non-WCF clients with Service Bus endpoints because it exposes REST endpoints for web services. Therefore, any client capable of REST-ful communication can interact with services (listeners) hosted in the Service Bus via the WebHttpRelayBinding. However, if more sophisticated security and reliability features are required, then WS2007HttpRelayBinding would be more appropriate.

The following example shows how to define and use WebHttpRelayBinding in an application configuration file. The binding in this example has client authentication turned off, which means that the client is not required to present a security token to the Windows Azure Service Bus.

<system.serviceModel>
  <bindings>
    <!-- Application Binding -->
    <webHttpRelayBinding>
      <binding name="customBinding">
        <!-- Turn off client authentication so that client does not need to present credential through browser or fiddler -->
        <security relayClientAuthenticationType="None" />
      </binding>
    </webHttpRelayBinding>
  </bindings>

  <services>
    <!-- Application Service -->
    <service name="Microsoft.ServiceBus.Samples.ImageService">
      <endpoint name="RelayEndpoint"
                contract="Microsoft.ServiceBus.Samples.IImageContract"
                binding="webHttpRelayBinding"
                bindingConfiguration="customBinding"
                behaviorConfiguration="sharedSecretClientCredentials"
                address="" />
    </service>
  </services>

  <behaviors>
    <!-- Specify service and endpoint behaviors here. -->
  </behaviors>

</system.serviceModel>

The following example illustrates the use of WebHttpRelayBinding programmatically with custom settings. The custom binding has client authentication turned off, which means that the client is not required to present a security token to the Windows Azure Service Bus. This example is a modified version of the WebHttp SDK sample, which specifies the binding for the service endpoint programmatically instead of specifying it in the application configuration file. The WebHttp SDK sample can be found in the SDK install directory under \Samples\ServiceBus\ExploringFeatures\Bindings\WebHttp.

This example starts by specifying the credentials the service application is expected to send to the Windows Azure Service Bus by creating an endpoint behavior. Next, it creates the binding, the service address, and starts the web service host. After starting the web service, the user can use a browser to get the image that the service exposes at the specified URL.

// Configure the credentials for the service and client endpoints through an endpoint behavior.
TransportClientEndpointBehavior relayCredentials = new TransportClientEndpointBehavior();
relayCredentials.CredentialType = TransportClientCredentialType.SharedSecret;
relayCredentials.Credentials.SharedSecret.IssuerName = issuerName;
relayCredentials.Credentials.SharedSecret.IssuerSecret = issuerSecret;

// Create the binding with custom settings.
WebHttpRelayBinding binding = new WebHttpRelayBinding();
binding.Security.RelayClientAuthenticationType = RelayClientAuthenticationType.None;

// Get the service URI.
Uri address = ServiceBusEnvironment.CreateServiceUri("https", serviceNamespace, "Image");

// Create the web service host.
WebServiceHost host = new WebServiceHost(typeof(ImageService), address);
// Add the service endpoint with the WebHttpRelayBinding binding.
host.AddServiceEndpoint(typeof(IImageContract), binding, address);
// Add the credentials through the endpoint behavior.
host.Description.Endpoints[0].Behaviors.Add(relayCredentials);
// Start the service.
host.Open();

Console.WriteLine("Copy the following address into a browser to see the image: ");
Console.WriteLine(address + "GetImage");
Console.WriteLine();
Console.WriteLine("Press [Enter] to exit");
Console.ReadLine();

host.Close();

이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

커뮤니티 추가 항목

추가
표시:
© 2015 Microsoft