Compartir a través de

Propiedades y esquema de propiedades de adaptadores de WCF

  • Artículo

Obtenga información sobre las propiedades promocionadas en el esquema de propiedades del adaptador de WCF. Los adaptadores de WCF asignan valores a las propiedades que puede utilizar en su aplicación. El adaptador de WCF también proporciona un mecanismo para leer pero no promociona las propiedades personalizadas en el contexto de mensaje de BizTalk y un mecanismo para promocionar las propiedades personalizadas en el contexto de mensaje de BizTalk. Para obtener más información, vea Encabezados SOAP con servicios WCF publicados.

Espacio de nombres:http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties

Acción

Especifique el campo de encabezado SOAPAction para los mensajes salientes. Puede especificar este valor de dos maneras diferentes: el formato de acción única y el formato de asignación de acciones. Si establece esta propiedad en el formato de acción única (por ejemplo, http://contoso.com/Svc/Op1 ), el encabezado SOAPAction para los mensajes salientes siempre se establece en el valor especificado en esta propiedad.

Si establece esta propiedad en el formato de asignación de acciones, el encabezado SOAPAction saliente viene determinado por BTS. Propiedad de contexto de la operación . Por ejemplo, si esta propiedad se establece en el siguiente formato XML y BTS. La propiedad Operation se establece en Op1, el adaptador de envío de WCF usa http://contoso.com/Svc/Op1 para el encabezado SOAPAction saliente.

<BtsActionMapping>
<Operation Name="Op1" Action="http://contoso.com/Svc/Op1">
<Operation Name="Op2" Action="http://contoso.com/Svc/Op2">
</BtsActionMapping>

Si los mensajes salientes proceden de un puerto de orquestación, las instancias de orquestación establecen dinámicamente el BTS. Propiedad Operation con el nombre de la operación del puerto. Si los mensajes salientes se enrutan con enrutamiento basado en contenido, puede establecer bts. Propiedad Operation en los componentes de canalización. Esta propiedad se promociona automáticamente a partir de los mensajes entrantes con el formato de acción única.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores de envío de WCF

AffiliateApplicationName

Especificar la aplicación afiliada que se utilizará para el inicio de sesión único empresarial (SSO). Esta propiedad es necesaria si la propiedad UseSSO está establecida en True.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores de envío de WCF excepto el adaptador de WCF-NetNamedPipe

AlgorithmSuite

Especificar el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los que se indican en la especificación Security Policy Language (WS-SecurityPolicy).

Para obtener más información sobre los valores aplicables para la propiedad AlgorithmSuite , vea la propiedad Algorithm suite en el cuadro de diálogo Propiedades de transporte WCF-NetTcp, pestaña Enviar, Seguridad de la referencia de espacio de nombres de la API de desarrolladores y guía de la interfaz de usuario.

Tipo: Valor predeterminado de cadena: Basic256 Se aplica a:

  • Adaptador de WCF-BasicHttp
  • adaptador de WCF-NetMsmq
  • Adaptador de WCF-NetTcp
  • Adaptador de WCF-WSHttp

BindingConfiguration

Especifique una cadena XML con el <elemento de enlace> para configurar diferentes tipos de enlaces predefinidos proporcionados por Windows Communication Foundation (WCF). Para obtener más información sobre el enlace proporcionado por el sistema y el enlace personalizado, consulte los temas adecuados en Vea también.

Ejemplo:

<binding name="wsHttpBinding" transactionFlow="true">
<security><message clientCredentialType="UserName"></security>
</binding>

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: adaptador de WCF-Custom, adaptador de WCF-CustomIsolated

BindingType

Especifique qué tipo de enlace utilizar para el extremo. Para obtener más información sobre los valores aplicables para la propiedad BindingType , vea la propiedad Tipo de enlace en el cuadro de diálogo Propiedades de transporte personalizadas de WCF, pestaña Enviar, Enlace en la guía de la interfaz de usuario y la referencia del espacio de nombres de la API de desarrolladores.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: adaptador de WCF-Custom, adaptador de WCF-CustomIsolated

ClientCertificate

Especificar la huella digital del certificado X.509 para la autenticación de este puerto de envío en servicios. Esta propiedad es necesaria si la propiedad ClientCredentialsType está establecida en Certificate. El certificado que se va a usar para esta propiedad debe instalarse en el almacén Mi en la ubicación Usuario actual .

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a:

  • Adaptador de envío WCF-BasicHttp
  • Adaptador de envío WCF-WSHttp
  • WCF-NetTcp adaptador de envío
  • WCF-NetMsmq adaptador de envío

CloseTimeout

Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de cierre del canal.

Tipo: Valor predeterminado de cadena: 00:01:00 Se aplica a: Todos los adaptadores WCF excepto WCF-Custom y WCF-CustomIsolated

CustomDeadLetterQueue

Especifique el URI completo con el esquema net.msmq para la ubicación de la cola de mensajes fallidos por aplicación, donde se colocan los mensajes que han expirado o que han producido un error en la transferencia o entrega. Por ejemplo, net.msmq://localhost/deadLetterQueueName. La cola de componentes con problemas de entrega es una cola en el administrador de colas de la aplicación de envío para los mensajes caducados que no se hayan entregado. Esta propiedad es necesaria si la propiedad DeadLetterQueue está establecida en Custom.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: WCF-NetMsmq adaptador de envío

DeadLetterQueue

Especificar la cola de mensajes con problemas de entrega a la que se transferirán los mensajes que no se han podido entregar a la aplicación. Para obtener más información sobre los mensajes entregados a la cola de mensajes fallidos, vea el cuadro de diálogo Propiedades de transporte WCF-NetMsmq, pestaña Enviar, Enlace en la guía de la interfaz de usuario y la referencia del espacio de nombres de la API de desarrolladores.

Tipo: Valor predeterminado de cadena: Sistema se aplica a: WCF-NetMsmq adaptador de envío

DisableLocationOnFailure

Especificar si se va a deshabilitar la ubicación de recepción cuyo procesamiento de entrada no se puede realizar correctamente debido a un error de canalización de recepción o de enrutamiento. Es posible que desee establecer esta propiedad en True cuando las ubicaciones de recepción se pueden deshabilitar y la denegación de servicio (DoS) no es un problema.

Por ejemplo:

  • WCF-Custom adaptador: cuando la propiedad BindingType se establece en netMsmqBinding.
  • WCF-Custom adaptador: cuando la propiedad BindingType se establece en customBinding y la propiedad BindingConfiguration está configurada para usar canales personalizados que se basan en transportes en cola, como MSMQ.
  • WCF-CustomIsolated adaptador: cuando la propiedad BindingType se establece en customBinding y la propiedad BindingConfiguration está configurada para usar canales personalizados que se basan en transportes en cola, como MSMQ.
  • adaptador de WCF-NetMsmq

Tipo: Valor predeterminado booleano: False se aplica a:

  • adaptador de recepción de WCF-NetMsmq
  • adaptador de recepción de WCF-Custom
  • Adaptador de recepción WCF-CustomIsolated

EnableTransaction

El efecto de esta propiedad varía dependiendo del adaptador de WCF. Para obtener más información sobre esta propiedad, vea temas de procedimientos para cada adaptador de WCF en adaptadores de WCF.

Tipo: Boolean Se aplica a:

  • Adaptador de WCF-WSHttp
  • Adaptador de WCF-NetTcp
  • adaptador de WCF-NetNamedPipe
  • adaptador de WCF-NetMsmq

EndpointBehaviorConfiguration

Especifique una cadena XML con el <elemento de comportamiento> del <elemento endpointBehaviors> para configurar los valores de comportamiento de un punto de conexión WCF. Para obtener más información sobre el <elemento endpointBehaviors> , consulte el tema correspondiente en Vea también.

Ejemplo:

<behavior name="sampleBehavior"><callbackTimeouts/></behavior>

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: WCF-Custom adaptador de envío

EstablishSecurityContext

Especificar si el canal de seguridad establece una sesión segura. Una sesión segura establece un token de contexto de seguridad (SCT) antes de intercambiar los mensajes de la aplicación.

Tipo: Valor predeterminado booleano: True aplicado a: adaptador de WCF-WSHttp

FromAddress

Indicar la dirección de extremo de origen a través de la que se envían los mensajes WCF entrantes. La propiedad se promociona automáticamente desde los mensajes entrantes.

Tipo: Cadena se aplica a: todos los adaptadores WCF excepto el adaptador de envío WCF-NetMsmq

Encabezados

Especificar las referencias de extremo utilizadas para proporcionar información de dirección adicional más allá del URI. Cuando se usa esta propiedad, esta propiedad debe tener el < elemento headers> como elemento raíz. Todos los encabezados de dirección deben colocarse dentro del < elemento headers>. Esta propiedad se promociona automáticamente para los mensajes entrantes.

Ejemplo:

<headers>
<Region xmlns="Uri">"String"</Region>
<Member xmlns="Uri">"String"</Member>
</headers>

Tipo: Cadena se aplica a: Todos los adaptadores WCF

Identidad

Especificar la identidad del servicio que proporciona una ubicación de recepción o espera un puerto de envío. Los valores que se pueden especificar para la propiedad Identity difieren según la configuración de seguridad. Esta configuración permite a los clientes autenticar servicios. En el proceso de negociación entre los clientes y los servicios, la infraestructura de Windows Communication Foundation (WCF) asegurará que la identidad de los servicios coincide con los valores de los clientes.

Ejemplo:

<identity>
<userPrincipalName value="username@contoso.com"/>
</identity>

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores WCF

InboundBodyLocation

Especifique la selección de datos para el elemento Body SOAP de los mensajes WCF entrantes. Para obtener más información sobre cómo usar la propiedad InboundBodyLocation , vea Especificar el cuerpo del mensaje para los adaptadores WCF.

Tipo: Valor predeterminado de cadena: UseBodyElement

Los valores aplicables son:

  • UseBodyElement: use el contenido del elemento Cuerpo SOAP de un mensaje entrante para crear la parte del cuerpo del mensaje de BizTalk. Si el elemento Body tiene más de un elemento secundario, solo el primer elemento se convierte en la parte del cuerpo del mensaje de BizTalk.
  • UseEnvelope: cree la parte del cuerpo del mensaje de BizTalk a partir del sobre SOAP completo de un mensaje entrante.
  • UseBodyPath: use la expresión de ruta de acceso del cuerpo en la propiedad InboundBodyPathExpression para crear la parte del cuerpo del mensaje de BizTalk. La expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del elemento Cuerpo SOAP de un mensaje entrante. Esta propiedad sólo es válida para puertos de petición-respuesta.

Se aplica a: Todos los adaptadores WCF excepto WCF-NetMsmq enviar

InboundBodyPathExpression

Especificar la expresión de ruta de cuerpo para identificar una parte específica de un mensaje entrante utilizada para crear la parte del cuerpo del mensaje de BizTalk. Esta expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del nodo Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de cuerpo devuelve varios nodos, solo se elegirá el primero de ellos para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si la propiedad InboundBodyLocation está establecida en UseBodyPath. Para obtener más información sobre cómo usar la propiedad InboundBodyPathExpression , vea Esquema de propiedades y propiedades de adaptadores de WCF.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores WCF excepto el adaptador de envío WCF-NetMsmq

InboundHeaders

Utilice la propiedad InboundHeaders para acceder a los encabezados SOAP de los mensajes WCF entrantes. Los adaptadores de WCF copian todos los valores de encabezado SOAP en mensajes entrantes a esta propiedad, que incluyen encabezados SOAP y encabezados SOAP estándares que la infraestructura WCF usa para WS-Addressing, WS-Security y WS-AtomicTransaction. El valor contenido en la propiedad de contexto es una cadena que contiene datos XML con el < elemento raíz headers> y los encabezados SOAP entrantes se copian como elementos secundarios del < elemento headers>. Para obtener más información sobre cómo acceder a los encabezados SOAP con los adaptadores WCF, vea el ejemplo del SDK, Using Custom SOAP Headers with the WCF Adapters, from https://go.microsoft.com/fwlink/?LinkId=79960.

Tipo: Cadena se aplica a: todos los adaptadores WCF excepto el adaptador de envío WCF-NetMsmq

InboundNodeEncoding

Especifique el tipo de codificación que usa el adaptador de recepción de WCF para descodificar el nodo identificado por la expresión de ruta de acceso del cuerpo especificada en InboundBodyPathExpression. Esta propiedad es necesaria si la propiedad InboundBodyLocation está establecida en UseBodyPath.

Tipo: Valor predeterminado de cadena: XML

Los valores aplicables son:

  • Base64: codificación base64
  • Hex: codificación hexadecimal
  • Cadena: codificación de texto - UTF-8.
  • XML: los adaptadores WCF crean el cuerpo del mensaje de BizTalk con el XML externo del nodo seleccionado por la expresión de ruta de acceso del cuerpo en InboundBodyPathExpression.

Se aplica a: todos los adaptadores WCF excepto el adaptador de envío de WCF-NetMsmq

IsFault

Indicar si los mensajes de error SOAP se han recibido. La propiedad se promociona automáticamente desde los mensajes entrantes.

Nota

La propiedad IsFault no se puede usar para comprobar los mensajes recibidos en busca de errores de transporte, como el error HTTP 404 (archivo o directorio no encontrado).

Tipo: booleano se aplica a: todos los adaptadores WCF excepto el adaptador de envío de WCF-NetMsmq

LeaseTimeout

Especificar la duración máxima de una conexión agrupada activa. Después de transcurrir el tiempo especificado, la conexión se cierra cuando se atiende la solicitud actual.

El adaptador de WCF-NetTcp aprovecha la clase NetTcpBinding para comunicarse con un punto de conexión. Al usar NetTcpBinding en escenarios de carga equilibrada, considere la posibilidad de reducir el tiempo de espera de concesión predeterminado. Para obtener más información sobre el equilibrio de carga al usar NetTcpBinding, consulte el tema correspondiente en Consulte también.

Tipo: Valor predeterminado de cadena: 00:05:00 Se aplica a: WCF-NetTcp adaptador de recepción

MaxConcurrentCalls

Especificar el número de llamadas concurrentes en una instancia de servicio única. Las llamadas que superan el límite se ponen en cola. Establecer este valor en 0 equivale a establecerlo en Int32.MaxValue.

Nota

No se puede realizar el seguimiento de esta propiedad en la base de datos de importación principal de BAM con los perfiles de seguimiento.

Tipo: Valor predeterminado entero: 200 Se aplica a: Todos los adaptadores de recepción wcF excepto los adaptadores de WCF-Custom y WCF-CustomIsolated

MaxConnections

Especificar el número máximo de conexiones que el agente de escucha puede tener esperando la aceptación de la aplicación. Cuando se supera este valor de cuota, se pierden las nuevas conexiones entrantes en lugar de esperar a ser aceptadas.

Nota

Ya que esta es una propiedad de controlador de adaptador, éste no puede configurarse en componentes de canalización y orquestaciones.

Nota

No se puede realizar el seguimiento de esta propiedad en la base de datos de importación principal de BAM con los perfiles de seguimiento.

Tipo: Valor predeterminado entero: 10 Se aplica a: adaptador de WCF-NetNamedPipe, adaptador de WCF-NetTcp

MaxReceivedMessageSize

Especificar el tamaño máximo, en bytes, para mensajes (con encabezados incluidos) que se pueden recibir a través de la red. El tamaño de los mensajes se limita mediante la cantidad de memoria asignada a cada mensaje. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS).

Tipo: Valor predeterminado entero: 65536 Se aplica a:

  • Adaptador de WCF-BasicHttp
  • Adaptador de WCF-WSHttp
  • Adaptador de WCF-NetTcp
  • adaptador de WCF-NetNamedPipe
  • WCF-NetMsmq adaptador de recepción

MessageClientCredentialType

Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación de cliente mediante la seguridad basada en mensajes.

Los valores aplicables son distintos para cada adaptador de WCF. Para obtener más información sobre la propiedad MessageClientCredentialType , vea temas de procedimientos para cada adaptador wcF en adaptadores WCF.

Tipo: Cadena se aplica a:

  • Adaptador de WCF-BasicHttp
  • Adaptador de WCF-WSHttp
  • Adaptador de WCF-NetTcp
  • adaptador de WCF-NetNamedPipe

MessageEncoding

Especificar el codificador que se usa para codificar el mensaje SOAP.

Tipo: Valor predeterminado de cadena: Texto

Valores aplicables:

  • Texto: usar un codificador de mensajes de texto
  • Mtom: Usar un codificador de organización de transmisión de mensajes 1.0 (MTOM)

Se aplica a: adaptador de WCF-BasicHttp, adaptador de WCF-WSHttp

MsmqAuthenticationMode

Especificar cómo el transporte de MSMQ debe autenticar el mensaje.

Tipo: Valor predeterminado de cadena: WindowsDomain Para obtener más información sobre los valores aplicables para la propiedad MsmqAuthenticationMode , vea la propiedad modo de autenticación MSMQ en el cuadro de diálogo Propiedades de transporte de WCF-NetMsmq, Enviar, Seguridad en la guía de la interfaz de usuario y la referencia del espacio de nombres de la API de desarrolladores. Se aplica a: adaptador de WCF-NetMsmq

MsmqEncryptionAlgorithm

Especificar el algoritmo que se usará para el cifrado de mensajes a través de la red al transferir mensajes entre los administradores de cola de mensajes. Esta propiedad solo está disponible si la propiedad MsmqProtectionLevel está establecida en EncryptAndSign.

Tipo: Valor predeterminado de cadena: RC4Stream

Los valores aplicables son: RC4Stream, AES

Se aplica a: adaptador de WCF-NetMsmq

MsmqProtectionLevel

Especificar el modo en que los mensajes están protegidos en el nivel de transporte de MSMQ.

Tipo: Valor predeterminado de cadena: Sign

Los valores aplicables son:

  • Ninguno: sin protección
  • Firmar: los mensajes están firmados
  • EncryptAndSign: Los mensajes se cifran y firman. Para usar este nivel de protección, debe habilitar la integración de Active Directory para MSMQ.

Se aplica a: adaptador de WCF-NetMsmq

MsmqSecureHashAlgorithm

Especificar el algoritmo hash que se usará para calcular la síntesis del mensaje. Esta propiedad no está disponible si la propiedad MsmqProtectionLevel está establecida en None.

Tipo: Valor predeterminado de cadena: SHA1

Los valores aplicables son: MD5, SHA1, SHA25, SHA512

Se aplica a: adaptador de WCF-NetMsmq

NegotiateServiceCredential

Especificar si la credencial de servicio se suministra en este cliente fuera de banda o se obtiene del servicio en el cliente a través de un proceso de negociación. Este tipo de negociación es un precursor del intercambio de mensajes usual.

Si la propiedad MessageClientCredentialType es igual a None, Username o Certificate, establecer esta propiedad en False implica que el certificado de servicio está disponible en el cliente fuera de banda y que el cliente debe especificar el certificado de servicio. Este modo es interoperable con pilas SOAP que implementan WS-Trust y WS-SecureConversation.

Si la propiedad MessageClientCredentialType está establecida en Windows, al establecer esta propiedad en False se especifica la autenticación basada en Kerberos. Esto significa que el cliente y el servicio deben formar parte del mismo dominio Kerberos. Este modo es interoperable con pilas SOAP que implementan el perfil de token de Kerberos (tal y como se define en OASIS WSS TC), así como WS-Trust y WS-SecureConversation.

Cuando esta propiedad es True, provoca una negociación SOAP de .NET que tuneliza el intercambio de SPNego a través de mensajes SOAP.

Tipo: Valor predeterminado booleano: True Se aplica a: adaptador de WCF-WSHttp

OpenTimeout

Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de apertura del canal.

Nota

No se puede realizar el seguimiento de esta propiedad en la base de datos de importación principal de BAM con los perfiles de seguimiento.

Tipo: Valor predeterminado de cadena: 00:01:00 Se aplica a: Todos los adaptadores WCF excepto los adaptadores de WCF-Custom y WCF-CustomIsolated

OrderedProcessing

Especifica si los mensajes se procesan en serie. Cuando se selecciona esta propiedad, esta ubicación de recepción admite la entrega de mensajes ordenada cuando se usa junto con un puerto de envío de mensajería o orquestación de BizTalk que tiene la opción Entrega ordenada establecida Trueen . Para obtener más información sobre la opción Entrega ordenada , consulte los temas adecuados en Vea también.

Esta propiedad es aplicable en los siguientes casos:

  • WCF-Custom adaptador: cuando la propiedad BindingType está establecida en netMsmqBinding
  • WCF-Custom adaptador: cuando la propiedad BindingType se establece en customBinding y la propiedad BindingConfiguration está configurada para usar canales personalizados que se basan en transportes que admiten la entrega ordenada, como MSMQ.
  • WCF-CustomIsolated adaptador: cuando la propiedad BindingType se establece en customBinding y la propiedad BindingConfiguration está configurada para usar canales personalizados que se basan en transportes que admiten la entrega ordenada.
  • adaptador de WCF-NetMsmq

Tipo: Valor predeterminado de cadena: False Se aplica a:

  • adaptador de recepción de WCF-NetMsmq
  • adaptador de recepción de WCF-Custom
  • Adaptador de recepción WCF-CustomIsolated

OutboundBodyLocation

Especifique la selección de datos para el elemento Cuerpo SOAP de los mensajes WCF salientes. Para obtener más información sobre cómo usar la propiedad OutboundBodyLocation , vea Especificar el cuerpo del mensaje para los adaptadores de WCF.

Tipo: Valor predeterminado de cadena: UseBodyElement

Los valores aplicables son:

  • UseBodyElement: use la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Cuerpo de SOAP para un mensaje saliente
  • UseTem***plate: use la plantilla proporcionada en la propiedad OutboundXMLTemplate para crear el contenido del elemento Cuerpo SOAP para un mensaje saliente.

Se aplica a: Todos los adaptadores WCF excepto el adaptador de recepción WCF-NetMsmq

OutboundCustomHeaders

Especificar encabezados SOAP personalizados para mensajes salientes. Cuando se usa esta propiedad, la propiedad debe tener el < elemento headers> como elemento raíz. Todos los encabezados SOAP personalizados deben colocarse dentro del < elemento headers>. Si el valor del encabezado SOAP personalizado es una cadena vacía, debe asignar <encabezados>< o <encabezados>> a esta propiedad. Para obtener más información sobre cómo usar encabezados SOAP con los adaptadores WCF, vea el ejemplo del SDK, Using Custom SOAP Headers with the WCF Adapters, from https://go.microsoft.com/fwlink/?LinkId=79960.

Tipo: Cadena se aplica a: todos los adaptadores WCF excepto el adaptador de recepción WCF-NetMsmq

OutboundXmlTemplate

Especifique la plantilla con formato XML para el contenido del elemento Cuerpo SOAP de un mensaje saliente. Esta propiedad es necesaria si la propiedad OutboundBodyLocation está establecida en UseTemplate. Para obtener más información sobre cómo usar la propiedad OutboundXMLTemplate , vea Especificar el cuerpo del mensaje para los adaptadores de WCF.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores WCF excepto el adaptador de recepción WCF-NetMsmq

Contraseña

Especifique la contraseña que se usará para la autenticación con el servidor de destino cuando la propiedad UseSSO esté establecida en False.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores de envío de WCF excepto el adaptador de WCF-NetNamedPipe

PropagateFaultMessage

Especificar si se enrutan o se suspenden mensajes que generan errores en el procesamiento de salida. Esta propiedad sólo es válida para puertos de petición-respuesta.

Nota

No se puede realizar el seguimiento de esta propiedad en la base de datos de importación principal de BAM con los perfiles de seguimiento.

Tipo: Valor predeterminado booleano: True

Los valores aplicables son:

  • True: enrute el mensaje que produce un error en el procesamiento saliente a una aplicación de suscripción (por ejemplo, otro puerto de recepción o programación de orquestación).
  • False: Suspender mensajes con error y generar una confirmación negativa (NACK)

Se aplica a: Todos los adaptadores de envío de WCF excepto el adaptador de WCF-NetMsmq

ProxyAddress

Especifique la dirección del servidor proxy. Use el esquema https o http en función de la configuración de seguridad. Esta dirección puede ir seguida de dos puntos y el número de puerto. La propiedad es necesaria si la propiedad ProxyToUse está establecida en UserSpecified (por ejemplo, http://127.0.0.1:8080).

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: WCF-BasicHttp adaptador de envío, WCF-WSHttp adaptador de envío

ProxyPassword

Especifique la contraseña que se va a usar para el servidor proxy especificado en la propiedad ProxyAddress .

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: WCF-BasicHttp adaptador de envío, WCF-WSHttp adaptador de envío

ProxyToUse

Especificar el servidor de proxy que se va a utilizar para el tráfico HTTP saliente.

Tipo: Valor predeterminado de cadena: Ninguno

Los valores aplicables son:

  • Ninguno: no use un servidor proxy para este puerto de envío.
  • Valor predeterminado: use la configuración de proxy en el controlador de envío que hospeda este puerto de envío.
  • UserSpecified: use el servidor proxy especificado en la propiedad ProxyAddress .

Se aplica a: WCF-BasicHttp adaptador de envío, WCF-WSHttp adaptador de envío

ProxyUserName

Especifique el nombre de usuario que se usará para el servidor proxy especificado en la propiedad ProxyAddress . La propiedad es necesaria si la propiedad ProxyToUse está establecida en UserSpecified.

Para obtener más información sobre esta propiedad, vea How to Configure a WCF-WSHttp Send Port and Configure a WCF-BasicHttp Send Port.

Tipo: Cadena se aplica a: WCF-BasicHttp adaptador de envío, WCF-WSHttp adaptador de envío

ReplyToAddress

Indicar la dirección de extremo de respuesta para los mensajes WCF salientes que corresponden a los mensajes entrantes recibidos a través de las ubicaciones de recepción de solicitud-respuesta. La propiedad se promociona automáticamente desde los mensajes entrantes.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores WCF excepto el adaptador de WCF-NetMsmq

SecurityMode

Especificar el tipo de seguridad que se usa. Los valores aplicables son distintos para cada adaptador de WCF. Para obtener más información sobre la propiedad SecurityMode , vea temas de procedimientos para cada adaptador wcF en adaptadores WCF.

Nota

No se puede realizar el seguimiento de esta propiedad en la base de datos de importación principal de BAM con los perfiles de seguimiento.

Tipo: Cadena se aplica a: todos los adaptadores WCF excepto los adaptadores de WCF-Custom y WCF-CustomIsolated

SendTimeout

Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de envío. Este valor especifica un marco temporal para que se complete toda la interacción, incluso si el remitente envía un mensaje de gran tamaño.

Tipo: Valor predeterminado de cadena: 00:01:00 Se aplica a: Todos los adaptadores WCF excepto los adaptadores de WCF-Custom y WCF-CustomIsolated

ServiceBehaviorConfiguration

Especifique una cadena XML con el <elemento de comportamiento> del <elemento serviceBehaviors> para configurar los valores de comportamiento de un servicio WCF. Para obtener más información sobre el <elemento serviceBehaviors> , consulte el tema correspondiente en Vea también.

Ejemplo:

<behavior name="SampleServiceBehavior">
<serviceAuthorization principalPermissionMode="UseAspNetRoles"/>
<serviceCredentials>
<serviceCertificate findValue="539d9ab3089bb6dc187fa7dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint"/>
</serviceCredentials>
<serviceMetadata httpGetEnabled="true"/>
</behavior>

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: WCF-Custom adaptador de recepción, WCF-CustomIsolated adaptador

ServiceCertificate

Si esta propiedad se usa para ubicaciones de recepción, especifique la huella digital del certificado X.509 para las ubicaciones de recepción que los clientes utilizan para autenticar el servicio. El certificado que se va a usar para esta propiedad debe instalarse en mi almacén en la ubicación Usuario actual .

Si esta propiedad se usar para puertos de envío, especifique la huella digital del certificado X.509 para autenticar el servicio al que este puerto de envío envía los mensajes. El certificado que se va a usar para esta propiedad debe instalarse en el almacén Other Personas en la ubicación del equipo local.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a:

  • Adaptador de WCF-BasicHttp
  • adaptador de WCF-NetMsmq
  • Adaptador de WCF-WSHttp
  • Adaptador de recepción WCF-NetTcp

SuspendMessageOnFailure

Especificar si se va a suspender el mensaje de solicitud cuyo procesamiento de entrada no se puede realizar correctamente debido a un error de canalización de recepción o de enrutamiento.

Tipo: Valor predeterminado booleano: True Se aplica a: Todos los adaptadores de recepción de WCF

TextEncoding

Especifique la codificación del juego de caracteres que se usará para emitir mensajes en el enlace cuando la propiedad MessageEncoding esté establecida en Text.

Nota

No se puede realizar el seguimiento de esta propiedad en la base de datos de importación principal de BAM con los perfiles de seguimiento.

Tipo: Valor predeterminado de cadena: utf-8

Los valores aplicables son:

  • unicodeFFF: codificación BigEndian de Unicode
  • utf-16: codificación de 16 bits
  • utf-8: codificación de 8 bits

Se aplica a: adaptador de WCF-BasicHttp, adaptador de WCF-WSHttp

timeToLive

Especificar el período de validez de los mensajes antes de que caduquen y se coloquen en la cola de mensajes con problemas de entrega. Esta propiedad se define para garantizar que los mensajes con limitaciones temporales no se conviertan en obsoletos antes de que un puerto de envío los procese. Se dice que los mensajes que se encuentren en una cola y no hayan sido consumidos por este puerto de envío en el intervalo especificado caducarán. Los mensajes caducados se envían a una cola especial denominada cola de mensajes con problemas de entrega. La ubicación de la cola de mensajes fallidos se establece con la propiedad DeadLetterQueue .

Tipo: Valor predeterminado de cadena: 1.00:00:00 Se aplica a: WCF-NetMsmq adaptador de envío

En

Especificar la dirección de extremo de destino para mensajes WCF salientes que envían los puertos de envío WCF.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores de envío de WCF

TransactionProtocol

Especificar el protocolo de transacción que se usará con este enlace. Esta propiedad es necesaria si la propiedad EnableTransaction está establecida en True.

Tipo: Valor predeterminado de cadena: OleTransaction

Los valores aplicables son: OleTransaction, WS-AtomicTransaction

Se aplica a: adaptador de WCF-NetNamedPipe, adaptador de WCF-NetTcp

TransportClientCredentialType

Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación del puerto de envío. Los valores aplicables son distintos para cada adaptador de WCF. Para obtener más información sobre la propiedad TransportClientCredentialType , vea temas de procedimientos para cada adaptador wcF en adaptadores WCF.

Tipo: Cadena se aplica a: adaptador de WCF-Basic, adaptador de WCF-NetTcp, adaptador de WCF-WSHttp

TransportProtectionLevel

Especificar la seguridad en el nivel de transporte TCP. Si se firman los mensajes, se reduce el riesgo de que manipulen el mensaje terceros mientras éste se transfiere. El cifrado proporciona privacidad de nivel de datos durante el transporte.

Tipo: Valor predeterminado de cadena: EncryptAndSign

Los valores aplicables son:

  • Ninguno: sin protección
  • Firmar: los mensajes están firmados
  • EncryptAndSign: los mensajes se cifran y firman

Se aplica a: adaptador de WCF-NetTcp, adaptador de WCF-NetNamedPipe

UserName

Especifique el nombre de usuario que se usará para la autenticación con el servidor de destino cuando la propiedad UseSSO esté establecida en False. No tiene que usar el formato dominio\usuario para esta propiedad.

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: Todos los adaptadores de envío de WCF excepto el adaptador de WCF-NetNamedPipe

UseSourceJournal

Especifique si las copias de los mensajes procesados por este puerto de envío deben almacenarse en la cola del diario de origen.

Tipo: Valor predeterminado booleano: False se aplica a: WCF-NetMsmq adaptador de envío

UseSSO

Especificar si se utiliza el inicio de sesión único (SSO) para recuperar credenciales de cliente para la autenticación con el servidor de destino.

Nota No se puede realizar un seguimiento de esta propiedad en la base de datos de importación principal de BAM con perfiles de seguimiento.

Tipo: valor predeterminado booleano: False se aplica a: todos los adaptadores de envío de WCF excepto el adaptador de WCF-NetNamedPipe

ReferencedBindings

Especifique las configuraciones de enlace a las que hace referencia el atributo bindingConfiguration del <elemento issuer> para wsFederationHttpBinding y customBinding, que indica el servicio de token de seguridad (STS) que emite tokens de seguridad. Para obtener más información sobre el <elemento issuer> , vea el tema "<issuer>" en https://go.microsoft.com/fwlink/?LinkId=83476.

La información de enlace que incluye el <elemento issuer> para wsFederationHttpBinding y customBinding se puede configurar a través de la propiedad BindingConfiguration de los adaptadores de WCF-Custom y WCF-CustomIsolated. Todas las configuraciones de enlace a las que se hace referencia para esta propiedad deben colocarse en forma de elemento <bindings> .

Nota

El atributo bindingConfiguration del <elemento issuer> debe hacer referencia a un nombre de enlace válido en esta propiedad.

Nota

El <elemento issuer> de las configuraciones de enlace a las que se hace referencia también puede hacer referencia a una configuración de enlace diferente en esta propiedad si esta cadena de referencia no realiza una dependencia circular.

Ejemplo:

WCF.BindingConfiguration = @"<wsFederationHttpBinding>
<binding name=""sampleBinding"">
<security mode=""Message"">
<message issuedKeyType=""AsymmetricKey"">
<issuer address=""http://www.contoso.com/samplests"" binding=""wsFederationHttpBinding"" bindingConfiguration=""**contosoSTSBinding**""/>
</message>
</security>
</binding>
</wsFederationHttpBinding>";
WCF.ReferencedBinding =@"<bindings>
<wsFederationHttpBinding>
<binding name=""**contosoSTSBinding**"">
<security mode=""Message"">
<message negotiateServiceCredential=""false"">
<issuer address=""https://northwind.com/samplests"" bindingConfiguration=""**northwindBinding**"" binding=""wsHttpBinding"">
</issuer>
</message>
</security>
</binding>
</wsFederationHttpBinding>
<wsHttpBinding>
<binding name=""**northwindBinding**"">
<security mode=""Message"">
<message clientCredentialType=""Certificate""/>
</security>
</binding>
</wsHttpBinding>
</bindings>"

Nota

La propiedad ReferencedBinding no debe contener la configuración de enlace utilizada en la propiedad BindingConfiguration .

Tipo: Valor predeterminado de cadena: una cadena vacía Se aplica a: adaptador de WCF-Custom, adaptador de WCF-CustomIsolated

Consulte también

Comportamiento de los adaptadores<de WCF del comportamiento> de <los enlaces endpointBehaviors>de <serviceBehaviors>Entrega ordenada de mensajes de equilibrio<de carga><>