Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Define un enlace interoperable que proporciona compatibilidad con las versiones correctas de los Securityelementos de enlace , ReliableSessiony TransactionFlow .
<configuración>
<system.serviceModel>
<Enlaces>
<ws2007HttpBinding>
Syntax
<ws2007HttpBinding>
<binding allowCookies="Boolean"
bypassProxyOnLocal="Boolean"
closeTimeout="TimeSpan"
hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
maxBufferPoolSize="integer"
maxReceivedMessageSize="Integer"
messageEncoding="Text/Mtom"
name="string"
openTimeout="TimeSpan"
proxyAddress="URI"
receiveTimeout="TimeSpan"
sendTimeout="TimeSpan"
textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
transactionFlow="Boolean"
useDefaultWebProxy="Boolean">
<reliableSession ordered="Boolean"
inactivityTimeout="TimeSpan"
enabled="Boolean" />
<security mode="Message/None/Transport/TransportWithCredential">
<transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
realm="string" />
<message clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"
negotiateServiceCredential="Boolean"
algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
establishSecurityContext="Boolean" />
</security>
<readerQuotas maxArrayLength="Integer"
maxBytesPerRead="Integer"
maxDepth="Integer"
maxNameTableCharCount="Integer"
maxStringContentLength="Integer" />
</binding>
</ws2007HttpBinding>
Atributos y elementos
En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Attributes
| Atributo | Description |
|---|---|
allowCookies |
Valor que indica si el cliente acepta cookies y los propaga en solicitudes futuras. El valor predeterminado es false.Puede utilizar esta propiedad cuando interactúe con ASP.NET servicios web (ASMX) que usen cookies. Esto garantiza que las cookies que devuelve el servidor se copien automáticamente en todas las solicitudes de cliente futuras para ese servicio. |
bypassProxyOnLocal |
Valor que indica si se va a omitir el servidor proxy para las direcciones locales. El valor predeterminado es false. |
closeTimeout |
Valor TimeSpan que especifica el intervalo de tiempo para que se complete una operación de cierre. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00. |
hostNameComparisonMode |
Especifica el modo de comparación de nombres de host HTTP que se usa para analizar identificadores uniformes de recursos (URI). Este atributo es de tipo HostNameComparisonMode, que indica si el nombre de host se usa para llegar al servicio al buscar coincidencias en el URI. El valor predeterminado es StrongWildcard, que omite el nombre de host en la coincidencia. |
maxBufferPoolSize |
Tamaño máximo del grupo de búferes para este enlace. El valor predeterminado es 524 288 bytes (512 × 1024). Muchas partes de Windows Communication Foundation (WCF) usan búferes. La creación y destrucción de búferes cada vez que se usan es costosa, ya que es la recolección de elementos no utilizados para los búferes. Con los grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo cuando haya terminado. Esto evita la sobrecarga al crear y destruir búferes. |
maxReceivedMessageSize |
El tamaño máximo del mensaje, en bytes, incluidos los encabezados, que un canal configurado con este enlace, puede recibir. El remitente de un mensaje que supera este límite recibe un error soap. El receptor quita el mensaje y crea una entrada del evento en el registro de seguimiento. El valor predeterminado es 65536. |
messageEncoding |
Define el codificador usado para codificar el mensaje. Entre los valores válidos se incluyen los siguientes: - Text: use un codificador de mensajes de texto.- Mtom: use un codificador de organización de transmisión de mensajes 1.0 (MTOM).El valor predeterminado es Text.Este atributo es de tipo WSMessageEncoding. |
name |
Nombre de configuración del enlace. Este valor debe ser único porque se usa como identificación para el enlace. A partir de .NET Framework 4, los enlaces y los comportamientos no son necesarios para tener un nombre. Para obtener más información sobre la configuración predeterminada y los enlaces y comportamientos sin nombre, vea Configuración simplificada y Configuración simplificada para servicios WCF. |
openTimeout |
Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación abierta. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00. |
proxyAddress |
URI que especifica la dirección del proxy HTTP. Si useSystemWebProxy es true, esta configuración debe ser null. El valor predeterminado es null. |
receiveTimeout |
Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación de recepción. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00. |
sendTimeout |
Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación de envío. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00. |
textEncoding |
Especifica la codificación del juego de caracteres que se va a usar para emitir mensajes en el enlace. Entre los valores válidos se incluyen los siguientes: - UnicodeFffeTextEncoding: codificación Big Endian unicode.- Utf16TextEncoding: codificación de 16 bits.- Utf8TextEncoding: codificación de 8 bits.El valor predeterminado es Utf8TextEncoding.Este atributo es de tipo Encoding. |
transactionFlow |
Valor que especifica si el enlace admite el flujo de WS-Transactions. El valor predeterminado es false. |
useDefaultWebProxy |
Valor que especifica si se usa el proxy HTTP configurado automáticamente del sistema. El valor predeterminado es true. |
Elementos secundarios
| Elemento | Description |
|---|---|
| <seguridad> | Define la configuración de seguridad para el enlace. Este elemento es de tipo WSHttpSecurityElement. |
| <readerQuotas> | Define las restricciones sobre la complejidad de los mensajes SOAP que los puntos de conexión configurados con este enlace pueden procesar. Este elemento es de tipo XmlDictionaryReaderQuotasElement. |
| <reliableSession> | Especifica si las sesiones confiables se establecen entre puntos de conexión de canal. |
Elementos primarios
| Elemento | Description |
|---|---|
| <Enlaces> | Este elemento contiene una colección de enlaces estándar y personalizados. |
Observaciones
WS2007HttpBinding agrega un enlace proporcionado por el sistema similar a WSHttpBinding pero usa las versiones estándar Organization for the Advancement of Structured Information Standards (OASIS) de los protocolos ReliableSession, Security y TransactionFlow. No se requieren cambios en el modelo de objetos o la configuración predeterminada al usar este enlace.
Example
<configuration>
<system.ServiceModel>
<bindings>
<ws2007HttpBinding>
<binding closeTimeout="00:00:10"
openTimeout="00:00:20"
receiveTimeout="00:00:30"
sendTimeout="00:00:40"
bypassProxyOnLocal="false"
transactionFlow="false"
hostNameComparisonMode="WeakWildcard"
maxReceivedMessageSize="1000"
messageEncoding="Mtom"
proxyAddress="http://www.contoso.com"
textEncoding="utf-16"
useDefaultWebProxy="false">
<reliableSession ordered="false"
inactivityTimeout="00:02:00"
enabled="true" />
<security mode="Transport">
<transport clientCredentialType="Digest"
proxyCredentialType="None"
realm="someRealm" />
<message clientCredentialType="Windows"
negotiateServiceCredential="false"
algorithmSuite="Aes128"
defaultProtectionLevel="None" />
</security>
</binding>
</ws2007HttpBinding>
</bindings>
</system.ServiceModel>
</configuration>