Condividi tramite

Proprietà e schema proprietà degli adapter WCF

  • Articolo

Informazioni sulle proprietà alzate di livello nello schema delle proprietà dell'adapter WCF. Gli adapter WCF assegnano valori alle proprietà che è possibile utilizzare nell'applicazione. Includono inoltre un meccanismo che consente la scrittura, ma non l'innalzamento di livello delle proprietà personalizzate al contesto dei messaggi BizTalk, nonché un meccanismo per l'innalzamento di livello delle proprietà personalizzate al contesto dei messaggi BizTalk. Per altre informazioni, vedere Intestazioni SOAP con servizi WCF pubblicati.

Namespace:http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties

Azione

Specificare il campo intestazione SOAPAction per i messaggi in uscita. È possibile specificare questo valore in due modi diversi: il formato di azione singola e il formato di mapping delle azioni. Se si imposta questa proprietà nel formato a azione singola, ad esempio , http://contoso.com/Svc/Op1 l'intestazione SOAPAction per i messaggi in uscita viene sempre impostata sul valore specificato in questa proprietà.

Se si imposta questa proprietà nel formato di mapping delle azioni, l'intestazione SOAPAction in uscita viene determinata da BTS. Proprietà del contesto dell'operazione . Ad esempio, se questa proprietà è impostata sul formato XML seguente e su BTS. La proprietà Operation è impostata su Op1, l'adattatore di trasmissione WCF usa http://contoso.com/Svc/Op1 per l'intestazione SOAPAction in uscita.

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

Se i messaggi in uscita provengono da una porta di orchestrazione, le istanze di orchestrazione impostano dinamicamente BTS. Proprietà Operation con il nome dell'operazione della porta. Se i messaggi in uscita vengono instradati con il routing basato sul contenuto, è possibile impostare BTS. Proprietà Operation nei componenti della pipeline. Questa proprietà viene automaticamente alzata di livello dai messaggi in arrivo con il formato singola azione.

Tipo: Valore predefinito stringa: Stringa vuota Si applica a: Tutti gli adapter di trasmissione WCF

AffiliateApplicationName

Specifica l'applicazione affiliata da utilizzare per Enterprise Single Sign-On (SSO). Questa proprietà è obbligatoria se la proprietà UseSSO è impostata su True.

Tipo: Valore predefinito stringa: Stringa vuota Si applica a: Tutti gli adattatori di trasmissione WCF ad eccezione dell'adapter WCF-NetNamedPipe

AlgorithmSuite

Specificare gli algoritmi di crittografia dei messaggi e di incapsulamento della chiave. Questi algoritmi sono associati a quelli indicati nella specifica Security Policy Language (WS-SecurityPolicy).

Per altre informazioni sui valori applicabili per la proprietà AlgorithmSuite , vedere la proprietà Della suite di algoritmi nella finestra di dialogo Proprietà trasporto WCF-NetTcp, Invia, Sicurezza nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.

Tipo: Valore predefinito stringa: Basic256 Si applica a:

  • Adapter WCF-BasicHttp
  • Adapter WCF-NetMsmq
  • Adapter WCF-NetTcp
  • adapter WCF-WSHttp

BindingConfiguration

Specificare una stringa XML con l'elemento di <associazione> per configurare tipi diversi di associazioni predefinite fornite da Windows Communication Foundation (WCF). Per ulteriori informazioni sul binding fornito dal sistema e sul binding personalizzato, vedere gli argomenti pertinenti in Vedere anche.

Esempio:

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

Tipo: Valore predefinito stringa: stringa vuota Si applica a: adattatore WCF-Custom, adattatore WCF-CustomIsolated

BindingType

Specifica il tipo di binding da utilizzare per l'endpoint. Per altre informazioni sui valori applicabili per la proprietà BindingType , vedere la proprietà Binding Type nella finestra di dialogo Proprietà trasporto WCF-Custom, Send, Binding nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

Tipo: Valore predefinito stringa: stringa vuota Si applica a: adattatore WCF-Custom, adattatore WCF-CustomIsolated

ClientCertificate

Specifica l'identificazione personale del certificato X.509 per l'autenticazione della porta di trasmissione per i servizi. Questa proprietà è obbligatoria se la proprietà ClientCredentialsType è impostata su Certificate. Il certificato da utilizzare per questa proprietà deve essere installato nell'archivio Personale nel percorso Utente corrente .

Tipo: Valore predefinito stringa: stringa vuota Si applica a:

  • Adapter di trasmissione WCF-BasicHttp
  • Adapter di trasmissione WCF-WSHttp
  • Adapter di trasmissione WCF-NetTcp
  • Adapter di trasmissione WCF-NetMsmq

CloseTimeout

Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di chiusura di un canale.

Tipo: Valore predefinito stringa: 00:01:00 Si applica a: Tutti gli adattatori WCF ad eccezione di WCF-Custom e WCF-CustomIsolated

CustomDeadLetterQueue

Specificare l'URI completo con lo schema net.msmq per il percorso della coda dei messaggi non recapitabili per applicazione, in cui vengono inseriti i messaggi scaduti o che hanno avuto esito negativo del trasferimento o del recapito. Ad esempio, net.msmq://localhost/NomeCodaMessaggiNonRecapitabili. La coda dei messaggi non recapitabili è una coda del gestore delle code dell'applicazione di origine contenente i messaggi scaduti che sono risultati non recapitabili. Questa proprietà è obbligatoria se la proprietà DeadLetterQueue è impostata su Custom.

Tipo: Valore predefinito stringa: Stringa vuota Si applica a: WCF-NetMsmq adapter di trasmissione

DeadLetterQueue

Specificare la coda dei messaggi non recapitabili dove vengono trasferiti i messaggi che non è stato possibile consegnare all'applicazione. Per altre informazioni sui messaggi recapitati alla coda dei messaggi non recapitabili, vedere la finestra di dialogo Proprietà trasporto WCF-NetMsmq, Invia, Associazione nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

Tipo: Valore predefinito stringa: Sistema si applica a: WCF-NetMsmq adapter di trasmissione

DisableLocationOnFailure

Specificare se disattivare l'indirizzo di ricezione per il quale non è possibile eseguire l'elaborazione in ingresso a causa di un problema della pipeline di ricezione o di un errore di routing. È possibile impostare questa proprietà su True quando è possibile disabilitare i percorsi di ricezione e Denial of Service (DoS) non è un problema.

Ad esempio:

  • WCF-Custom adapter: quando la proprietà BindingType è impostata su netMsmqBinding.
  • WCF-Custom adapter: quando la proprietà BindingType è impostata su customBinding e la proprietà BindingConfiguration è configurata per l'utilizzo di canali personalizzati basati su trasporti in coda, ad esempio MSMQ.
  • WCF-CustomIsolated adapter: quando la proprietà BindingType è impostata su customBinding e la proprietà BindingConfiguration è configurata per l'utilizzo di canali personalizzati che si basano su trasporti in coda, ad esempio MSMQ
  • Adapter WCF-NetMsmq

Tipo: Valore predefinito booleano: False si applica a:

  • Adapter di ricezione WCF-NetMsmq
  • Adapter di ricezione WCF-Custom
  • Adapter di ricezione WCF-CustomIsolated

EnableTransaction

L'effetto di questa proprietà varia a seconda dell'adapter WCF. Per altre informazioni su questa proprietà, vedere gli argomenti sulle procedure per ogni adapter WCF negli adapter WCF.

Tipo: Valore booleano si applica a:

  • adapter WCF-WSHttp
  • Adapter WCF-NetTcp
  • Adapter WCF-NetNamedPipe
  • Adapter WCF-NetMsmq

EndpointBehaviorConfiguration

Specificare una stringa XML con l'elemento <behavior> dell'elemento <endpointBehaviors> per configurare le impostazioni di comportamento di un endpoint WCF. Per altre informazioni sull'elemento <endpointBehaviors> , vedere l'argomento appropriato in Vedere anche.

Esempio:

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

Tipo: Valore predefinito stringa: Stringa vuota Si applica a: WCF-Custom adapter di trasmissione

EstablishSecurityContext

Specifica se il canale di sicurezza stabilisce una sessione protetta. Una sessione protetta stabilisce un token del contesto di sicurezza prima di scambiare i messaggi dell'applicazione.

Tipo: Valore predefinito booleano: True applicato a: adattatore WCF-WSHttp

FromAddress

Indica l'indirizzo dell'endpoint di origine attraverso il quale vengono inviati i messaggi WCF in ingresso. Viene eseguito l'innalzamento automatico di livello della proprietà dai messaggi in ingresso.

Tipo: Stringa si applica a: Tutti gli adapter WCF ad eccezione dell'adapter di trasmissione WCF-NetMsmq

Intestazioni

Specifica i riferimenti agli endpoint utilizzati per fornire ulteriori informazioni sull'indirizzamento oltre all'URI. Quando questa proprietà viene utilizzata, questa proprietà deve avere l'elemento <headers> come elemento radice. Tutte le intestazioni di indirizzo devono essere inserite all'interno dell'elemento <headers> . Viene eseguito l'innalzamento automatico di livello di questa proprietà per i messaggi in ingresso.

Esempio:

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

Tipo: Stringa si applica a: Tutti gli adapter WCF

Identità

Specifica l'identità del servizio fornita da un indirizzo di ricezione o prevista da una porta di trasmissione. I valori che è possibile specificare per la proprietà Identity differiscono in base alla configurazione di sicurezza. Queste impostazioni consentono ai client di autenticare i servizi. Nel processo di handshake tra client e servizi, l'infrastruttura di Windows Communication Foundation (WCF) garantisce che l'identità dei servizi corrisponda ai valori dei client.

Esempio:

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

Tipo: Valore predefinito stringa: Stringa vuota Si applica a: Tutte le schede WCF

InboundBodyLocation

Specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in arrivo. Per altre informazioni sull'utilizzo della proprietà InboundBodyLocation , vedere Specifica del corpo del messaggio per gli adapter WCF.

Tipo: Valore predefinito stringa: UseBodyElement

I valori applicabili sono:

  • UseBodyElement: usare il contenuto dell'elemento SOAP Body di un messaggio in arrivo per creare la parte del corpo del messaggio BizTalk. Se l'elemento Body dispone di più di un elemento figlio, solo il primo elemento diventa la parte corpo del messaggio BizTalk.
  • UseEnvelope: creare la parte del corpo del messaggio BizTalk dall'intera SOAP Envelope di un messaggio in arrivo.
  • UseBodyPath: usare l'espressione del percorso del corpo nella proprietà InboundBodyPathExpression per creare la parte del corpo del messaggio BizTalk. Tale espressione viene valutata in base all'elemento figlio immediato dell'elemento SOAP Body di un messaggio in arrivo. Questa proprietà è valida solo per le porte sollecitazione-risposta.

Si applica a: tutti gli adapter WCF ad eccezione di WCF-NetMsmq send

InboundBodyPathExpression

Specificare l'espressione percorso del corpo per identificare una parte specifica di un messaggio in arrivo utilizzata per creare la parte corpo del messaggio BizTalk. Questa espressione del percorso del corpo viene valutata rispetto all'elemento figlio immediato del nodo CORPO SOAP di un messaggio in arrivo. Se questa espressione percorso del corpo restituisce più di un nodo, solo il primo nodo verrà scelto per la parte corpo del messaggio BizTalk. Questa proprietà è obbligatoria se la proprietà InboundBodyLocation è impostata su UseBodyPath. Per altre informazioni sull'utilizzo della proprietà InboundBodyPathExpression , vedere Proprietà e schema delle proprietà degli adapter WCF.

Tipo: Valore predefinito stringa: Stringa vuota Si applica a: Tutti gli adapter WCF ad eccezione dell'adattatore di trasmissione WCF-NetMsmq

InboundHeaders

Utilizzare la proprietà InboundHeaders per accedere alle intestazioni SOAP dei messaggi WCF in ingresso. Gli adapter WCF copiano tutti i valori delle intestazioni SOAP nei messaggi in ingresso in questa proprietà, incluse le intestazioni SOAP personalizzate e quelle standard utilizzate dall'infrastruttura WCF per valori quali WS-Addressing, WS-Security e WS-AtomicTransaction. Il valore contenuto nella proprietà context è una stringa contenente dati XML con l'elemento < radice delle intestazioni> e le intestazioni SOAP in ingresso vengono copiate come elementi figlio dell'elemento <headers>. Per altre informazioni su come accedere alle intestazioni SOAP con gli adattatori WCF, vedere l'esempio SDK, Uso di intestazioni SOAP personalizzate con gli adapter WCF da https://go.microsoft.com/fwlink/?LinkId=79960.

Tipo: Stringa si applica a: Tutti gli adapter WCF ad eccezione dell'adapter di trasmissione WCF-NetMsmq

InboundNodeEncoding

Specificare il tipo di codifica usato dall'adapter di ricezione WCF per decodificare il nodo identificato dall'espressione del percorso del corpo specificata in InboundBodyPathExpression. Questa proprietà è obbligatoria se la proprietà InboundBodyLocation è impostata su UseBodyPath.

Tipo: Valore predefinito stringa: XML

I valori applicabili sono:

  • Base64: codifica Base64
  • Esadecimale: codifica esadecimale
  • String: codifica testo UTF-8
  • XML: gli adapter WCF creano il corpo del messaggio BizTalk con il codice XML esterno del nodo selezionato dall'espressione del percorso del corpo in InboundBodyPathExpression.

Si applica a: tutti gli adapter WCF ad eccezione dell'adapter di trasmissione WCF-NetMsmq

IsFault

Indica se vengono ricevuti i messaggi di errore SOAP. Viene eseguito l'innalzamento automatico di livello della proprietà dai messaggi in ingresso.

Nota

Impossibile utilizzare la proprietà IsFault per verificare la presenza di errori di trasporto ricevuti, ad esempio l'errore HTTP 404 (File o Directory non trovato).

Tipo: Valore booleano si applica a: tutti gli adapter WCF ad eccezione dell'adapter di trasmissione WCF-NetMsmq

LeaseTimeout

Specifica la durata massima di una connessione in pool attiva. Allo scadere del periodo di tempo specificato, la connessione viene chiusa dopo l'elaborazione della richiesta corrente.

L'adattatore WCF-NetTcp sfrutta la classe NetTcpBinding per comunicare con un endpoint. Quando si usa NetTcpBinding in scenari con carico bilanciato, è consigliabile ridurre il timeout del lease predefinito. Per altre informazioni sul bilanciamento del carico quando si usa NetTcpBinding, vedere anche l'argomento appropriato in Vedere anche.

Tipo: Valore predefinito stringa: 00:05:00 Si applica a: WCF-NetTcp adapter di ricezione

MaxConcurrentCalls

Specifica il numero di chiamate simultanee a una singola istanza del servizio. Le chiamate oltre il limite vengono accodate. L'impostazione di questo valore su 0 equivale a impostarlo su Int32.MaxValue.

Nota

Non è possibile eseguire il rilevamento di questa proprietà nel database di importazione primaria BAM con i profili di rilevamento.

Tipo: Valore predefinito integer: 200 Si applica a: Tutti gli adattatori di ricezione WCF ad eccezione degli adattatori WCF-Custom e WCF-CustomIsolated

MaxConnections

Specificare il numero massimo di connessioni che il listener può supportare in attesa di accettazione da parte dell'applicazione. Quando questo valore della quota viene superato, le nuove connessioni in ingresso vengono eliminate anziché restare in attesa di essere accettate.

Nota

Poiché si tratta di una proprietà del gestore dell'adapter, non può essere configurata nei componenti della pipeline e nelle orchestrazioni.

Nota

Non è possibile eseguire il rilevamento di questa proprietà nel database di importazione primaria BAM con i profili di rilevamento.

Tipo: Valore predefinito integer: 10 Si applica a: adattatore WCF-NetNamedPipe, adattatore WCF-NetTcp

MaxReceivedMessageSize

Specificare le dimensioni massime in byte di un messaggio, intestazioni comprese, che è possibile ricevere durante la trasmissione. Le dimensioni dei messaggi sono limitate dalla quantità di memoria allocata per ogni messaggio. È possibile utilizzare questa proprietà per limitare l'esposizione ad attacchi di tipo Denial of Service (DoS).

Tipo: Valore predefinito integer: 65536 Si applica a:

  • Adapter WCF-BasicHttp
  • adapter WCF-WSHttp
  • Adapter WCF-NetTcp
  • Adapter WCF-NetNamedPipe
  • Adapter di ricezione WCF-NetMsmq

MessageClientCredentialType

Specificare il tipo di credenziali da utilizzare durante l'autenticazione del client con la sicurezza basata sui messaggi.

I valori applicabili variano a seconda dell'adapter WCF. Per altre informazioni sulla proprietà MessageClientCredentialType , vedere gli argomenti sulle procedure per ogni adapter WCF negli adapter WCF.

Tipo: Stringa si applica a:

  • Adapter WCF-BasicHttp
  • adapter WCF-WSHttp
  • Adapter WCF-NetTcp
  • Adapter WCF-NetNamedPipe

MessageEncoding

Specificare il codificatore utilizzato per la codifica del messaggio SOAP.

Tipo: Valore predefinito stringa: Testo

Valori applicabili:

  • Testo: usare un codificatore di messaggi di testo
  • Mtom: usare un codificatore MTOM (Message Transmission Organization Mechanism 1.0)

Si applica a: adattatore WCF-BasicHttp, adattatore WCF-WSHttp

MsmqAuthenticationMode

Specificare in che modo deve essere autenticato il messaggio da parte del trasporto MSMQ.

Tipo: Valore predefinito stringa: WindowsDomain Per altre informazioni sui valori applicabili per la proprietà MsmqAuthenticationMode , vedere la proprietà modalità di autenticazione MSMQ nella finestra di dialogo Proprietà trasporto WCF-NetMsmq, Invia, Sicurezza nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori. Si applica a: adattatore WCF-NetMsmq

MsmqEncryptionAlgorithm

Specificare l'algoritmo da utilizzare per la crittografia dei messaggi durante la trasmissione quando si trasferiscono messaggi tra gestori delle code di messaggi. Questa proprietà è disponibile solo se la proprietà MsmqProtectionLevel è impostata su EncryptAndSign.

Tipo: Valore predefinito stringa: RC4Stream

I valori applicabili sono: RC4Stream, AES

Si applica a: adattatore WCF-NetMsmq

MsmqProtectionLevel

Specificare la modalità di protezione dei messaggi al livello del trasporto MSMQ.

Tipo: Valore predefinito stringa: Firma

I valori applicabili sono:

  • Nessuna: nessuna protezione
  • Firma: i messaggi vengono firmati
  • EncryptAndSign: i messaggi sono crittografati e firmati. Per usare questo livello di protezione, è necessario abilitare l'integrazione di Active Directory per MSMQ

Si applica a: adattatore WCF-NetMsmq

MsmqSecureHashAlgorithm

Specificare l'algoritmo hash da utilizzare per il calcolo del digest del messaggio. Questa proprietà non è disponibile se la proprietà MsmqProtectionLevel è impostata su Nessuno.

Tipo: Valore predefinito stringa: SHA1

I valori applicabili sono: MD5, SHA1, SHA25, SHA512

Si applica a: adattatore WCF-NetMsmq

NegotiateServiceCredential

Specifica se le credenziali del servizio vengono sottoposte a provisioning presso il client fuori banda o se vengono ottenute dal servizio al client attraverso un processo di negoziazione. Tale negoziazione precede lo scambio di messaggi abituale.

Se la proprietà MessageClientCredentialType è uguale a None, Username o Certificate, impostare questa proprietà su False implica che il certificato del servizio sia disponibile al client fuori banda e che il client deve specificare il certificato del servizio. Questa modalità è interoperativa con gli stack SOAP che implementano WS-Trust e WS-SecureConversation.

Se la proprietà MessageClientCredentialType è impostata su Windows, impostare questa proprietà su False specifica l'autenticazione basata su Kerberos. Questo significa che il client e il servizio devono fare parte dello stesso dominio Kerberos. Questa modalità è interoperativa con gli stack SOAP che implementano il profilo del token Kerberos (come definito in OASIS WSS TC) nonché WS-Trust e WS-SecureConversation.

Quando questa proprietà è True, causa una negoziazione SOAP .NET che esegue lo scambio di SPNego sui messaggi SOAP.

Tipo: Valore predefinito booleano: True si applica a: scheda WCF-WSHttp

OpenTimeout

Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di apertura di un canale.

Nota

Non è possibile eseguire il rilevamento di questa proprietà nel database di importazione primaria BAM con i profili di rilevamento.

Tipo: Valore predefinito stringa: 00:01:00 Si applica a: Tutte le schede WCF tranne le schede WCF-Custom e WCF-CustomIsolated

OrderedProcessing

Specificare se i messaggi devono essere elaborati in modo seriale. Quando questa proprietà è selezionata, questa posizione di ricezione consente il recapito ordinato dei messaggi quando viene usato in combinazione con una porta di invio bizTalk o orchestrazione con l'opzione Recapito ordinato impostata su True. Per altre informazioni sull'opzione Recapito ordinato , vedere gli argomenti appropriati in Vedere anche.

Questa proprietà è applicabile nei casi seguenti:

  • WCF-Custom adapter: quando la proprietà BindingType è impostata su netMsmqBinding
  • WCF-Custom adapter: quando la proprietà BindingType è impostata su customBinding e la proprietà BindingConfiguration è configurata per usare canali personalizzati che si basano sui trasporti che supportano il recapito ordinato, ad esempio MSMQ.
  • WCF-CustomIsolated adapter: quando la proprietà BindingType è impostata su customBinding e la proprietà BindingConfiguration è configurata per usare canali personalizzati che si basano sui trasporti che supportano il recapito ordinato.
  • Adapter WCF-NetMsmq

Tipo: Valore predefinito stringa: False si applica a:

  • Adapter di ricezione WCF-NetMsmq
  • Adapter di ricezione WCF-Custom
  • Adapter di ricezione WCF-CustomIsolated

OutboundBodyLocation

Specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in uscita. Per altre informazioni su come usare la proprietà OutboundBodyLocation , vedere Specifica del corpo del messaggio per gli adapter WCF.

Tipo: Valore predefinito stringa: UseBodyElement

I valori applicabili sono:

  • UseBodyElement: usare la parte del corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita
  • UseTem**plate: usare il modello fornito nella proprietà OutboundXMLTemplate per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita

Si applica a: tutti gli adattatori WCF tranne l'adattatore di ricezione WCF-NetMsmq

OutboundCustomHeaders

Specifica le intestazioni SOAP personalizzate per i messaggi in uscita. Quando questa proprietà viene usata, la proprietà deve avere l'elemento <intestazioni> come elemento radice. Tutte le intestazioni SOAP personalizzate devono essere inserite all'interno dell'elemento <intestazioni> . Se il valore dell'intestazione SOAP personalizzato è una stringa vuota, è necessario assegnare <intestazioni/intestazioni>< o <intestazioni>> a questa proprietà. Per altre informazioni su come usare le intestazioni SOAP con gli adattatori WCF, vedere l'esempio SDK, Uso di intestazioni SOAP personalizzate con gli adattatori WCF, da https://go.microsoft.com/fwlink/?LinkId=79960.

Tipo: Stringa si applica a: Tutte le schede WCF tranne l'adattatore di ricezione WCF-NetMsmq

OutboundXmlTemplate

Specificare il modello formattato XML per il contenuto dell'elemento SOAP Body di un messaggio in uscita. Questa proprietà è necessaria se la proprietà OutboundBodyLocation è impostata su UseTemplate. Per altre informazioni su come usare la proprietà OutboundXMLTemplate , vedere Specifica del corpo del messaggio per gli adapter WCF.

Tipo: Valore predefinito stringa: una stringa vuota si applica a: Tutte le schede WCF tranne l'adattatore di ricezione WCF-NetMsmq

Password

Specificare la password da usare per l'autenticazione con il server di destinazione quando la proprietà UseSSO è impostata su False.

Tipo: Valore predefinito stringa: una stringa vuota si applica a: Tutti gli adattatori di invio WCF tranne l'adattatore WCF-NetNamedPipe

PropagateFaultMessage

Specifica se eseguire il routing o sospendere i messaggi per i quali non è stato possibile eseguire l'elaborazione in uscita. Questa proprietà è valida solo per le porte sollecitazione-risposta.

Nota

Non è possibile eseguire il rilevamento di questa proprietà nel database di importazione primaria BAM con i profili di rilevamento.

Tipo: Valore predefinito booleano: True

I valori applicabili sono:

  • True: instradare il messaggio che ha esito negativo nell'elaborazione in uscita a un'applicazione di sottoscrizione, ad esempio un'altra pianificazione di ricezione o orchestrazione.
  • False: sospendere i messaggi non riusciti e generare un riconoscimento negativo (NACK)

Si applica a: Tutti gli adattatori di invio WCF tranne l'adattatore WCF-NetMsmq

ProxyAddress

Specificare l'indirizzo del server proxy. Usare lo schema https o http a seconda della configurazione di sicurezza. L'indirizzo può essere seguito dai due punti e dal numero di porta, La proprietà è necessaria se la proprietà ProxyToUse è impostata su UserSpecified (ad esempio, http://127.0.0.1:8080)

Tipo: Valore predefinito stringa: una stringa vuota Si applica a: WCF-BasicHttp adattatore di invio, WCF-WSHttp adattatore di invio

ProxyPassword

Specificare la password da usare per il server proxy specificato nella proprietà ProxyAddress .

Tipo: Valore predefinito stringa: una stringa vuota Si applica a: WCF-BasicHttp adattatore di invio, WCF-WSHttp adattatore di invio

ProxyToUse

Specifica il server proxy da utilizzare per il traffico HTTP in uscita.

Tipo: Valore predefinito stringa: Nessuno

I valori applicabili sono:

  • Nessuno: non usare un server proxy per questa porta di invio
  • Impostazione predefinita: usare le impostazioni proxy nel gestore di invio che ospita questa porta di invio
  • UserSpecified: usare il server proxy specificato nella proprietà ProxyAddress

Si applica a: adattatore di trasmissione WCF-BasicHttp WCF-WSHttp adattatore di invio

ProxyUserName

Specificare il nome utente da usare per il server proxy specificato nella proprietà ProxyAddress . La proprietà è necessaria se la proprietà ProxyToUse è impostata su UserSpecified.

Per altre informazioni su questa proprietà, vedere Come configurare una porta di trasmissione WCF-WSHttp e configurare una porta di trasmissione WCF-BasicHttp.

Tipo: Stringa si applica a: scheda di trasmissione WCF-BasicHttp, WCF-WSHttp adattatore di invio

ReplyToAddress

Indica l'indirizzo dell'endpoint di risposta per i messaggi WCF in uscita che corrisponde ai messaggi in ingresso ricevuti tramite indirizzi di ricezione richiesta-risposta. Viene eseguito l'innalzamento automatico di livello della proprietà dai messaggi in ingresso.

Tipo: Valore predefinito stringa: una stringa vuota Si applica a: Tutte le schede WCF tranne l'adattatore WCF-NetMsmq

SecurityMode

Specificare il tipo di sicurezza utilizzato. I valori applicabili variano a seconda dell'adapter WCF. Per altre informazioni sulla proprietà SecurityMode , vedere argomenti di procedura per ogni scheda WCF negli adapter WCF.

Nota

Non è possibile eseguire il rilevamento di questa proprietà nel database di importazione primaria BAM con i profili di rilevamento.

Tipo: Stringa si applica a: Tutte le schede WCF tranne le schede WCF-Custom e WCF-CustomIsolated

SendTimeout

Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di invio. Questo valore specifica un intervallo di tempo necessario per il completamento di tutta l'interazione, anche se viene inviato un messaggio di grandi dimensioni.

Tipo: Valore predefinito stringa: 00:01:00 Si applica a: Tutte le schede WCF tranne le schede WCF-Custom e WCF-CustomIsolated

ServiceBehaviorConfiguration

Specificare una stringa XML con l'elemento comportamento> dell'elemento<<serviceBehaviors> per configurare le impostazioni di comportamento di un servizio WCF. Per altre informazioni sull'elemento serviceBehaviors>, vedere l'argomento< appropriato in Vedere anche.

Esempio:

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

Tipo: Valore predefinito stringa: una stringa vuota si applica a: WCF-Custom scheda di ricezione, WCF-CustomIsolated adattatore

ServiceCertificate

Se questa proprietà viene utilizzata per indirizzi di ricezione, specifica l'identificazione personale del certificato X.509 per gli indirizzi di ricezione utilizzati dai client per autenticare il servizio. Il certificato da usare per questa proprietà deve essere installato nell'archivio personale nel percorso utente corrente .

Se questa proprietà viene utilizzata per porte di trasmissione, specifica l'identificazione personale del certificato X.509 per l'autenticazione del servizio a cui questa porta di trasmissione invia messaggi. Il certificato da usare per questa proprietà deve essere installato nell'archivio Altre Persone nel percorso del computer locale.

Tipo: Valore predefinito stringa: una stringa vuota si applica a:

  • Adapter WCF-BasicHttp
  • Adapter WCF-NetMsmq
  • adapter WCF-WSHttp
  • Adapter di ricezione WCF-NetTcp

SuspendMessageOnFailure

Specificare se sospendere il messaggio di richiesta per cui non è possibile eseguire l'elaborazione in ingresso a causa di un problema della pipeline di ricezione o di un errore di routing.

Tipo: valore predefinito booleano: True si applica a: Tutti gli adattatori di ricezione WCF

TextEncoding

Specificare la codifica del set di caratteri da utilizzare per l'emissione di messaggi nell'associazione quando la proprietà MessageEncoding è impostata su Text.

Nota

Non è possibile eseguire il rilevamento di questa proprietà nel database di importazione primaria BAM con i profili di rilevamento.

Tipo: Valore predefinito stringa: utf-8

I valori applicabili sono:

  • unicodeFFF: codifica Unicode BigEndian
  • utf-16: codifica a 16 bit
  • utf-8: codifica a 8 bit

Si applica a: adattatore WCF-BasicHttp WCF-WSHttp

timeToLive

Specificare un intervallo di tempo che indica il periodo di validità dei messaggi prima che scadano e vengano inseriti nella coda dei messaggi non recapitabili. Questa proprietà viene impostata per verificare che i messaggi con limiti temporali non diventino obsoleti prima di essere elaborati da una porta di trasmissione. Un messaggio in una coda non gestito da questa porta di trasmissione nell'intervallo di tempo specificato viene considerato scaduto. I messaggi scaduti vengono inviati a una coda speciale definita coda dei messaggi non recapitabili. La posizione della coda di lettere non recapitabili viene impostata con la proprietà DeadLetterQueue .

Tipo: Valore predefinito stringa: 1.00:00:00 Si applica a: WCF-NetMsmq adattatore di invio

Per

Specifica l'indirizzo dell'endpoint di destinazione per i messaggi WCF in uscita inviati dalle porte di trasmissione WCF.

Tipo: Valore predefinito stringa: una stringa vuota si applica a: Tutti gli adattatori di invio WCF

TransactionProtocol

Specificare il protocollo di transazione da utilizzare con questo binding. Questa proprietà è necessaria se la proprietà EnableTransaction è impostata su True.

Tipo: Valore predefinito stringa: OleTransaction

I valori applicabili sono: OleTransaction, WS-AtomicTransaction

Si applica a: adattatore WCF-NetNamedPipe WCF-NetTcp

TransportClientCredentialType

Specificare il tipo di credenziali da utilizzare durante l'autenticazione della porta di trasmissione. I valori applicabili variano a seconda dell'adapter WCF. Per altre informazioni sulla proprietà TransportClientCredentialType , vedere argomenti relativi a ogni scheda WCF in Adapter WCF.

Tipo: Stringa si applica a: adattatore WCF-Basic, adattatore WCF-NetTcp, adattatore WCF-WSHttp

TransportProtectionLevel

Specifica la sicurezza al livello del trasporto TCP. La firma dei messaggi riduce il rischio di manomissione del messaggio a opera di terze parti durante il trasferimento. La crittografia garantisce la privacy a livello dei dati durante il trasporto.

Tipo: Valore predefinito stringa: EncryptAndSign

I valori applicabili sono:

  • Nessuna: nessuna protezione
  • Firma: i messaggi vengono firmati
  • EncryptAndSign: i messaggi vengono crittografati e firmati

Si applica a: adattatore WCF-NetTcp WCF-NetNamedPipe

UserName

Specificare il nome utente da usare per l'autenticazione con il server di destinazione quando la proprietà UseSSO è impostata su False. Non è necessario utilizzare il formato dominio\utente per questa proprietà.

Tipo: Valore predefinito stringa: una stringa vuota si applica a: Tutti gli adattatori di invio WCF tranne l'adattatore WCF-NetNamedPipe

UseSourceJournal

Specifica se le copie dei messaggi elaborati da questa porta di trasmissione devono essere archiviate nella coda del journal di origine.

Tipo: Valore predefinito booleano: False si applica a: WCF-NetMsmq adattatore di invio

UseSSO

Specificare se deve essere utilizzato il servizio Single Sign-On per recuperare le credenziali del client per l'autenticazione con il server di destinazione.

Nota Questa proprietà non può essere rilevata nel database di importazione primaria BAM con profili di rilevamento.

Tipo: valore predefinito booleano: False si applica a: Tutti gli adattatori di invio WCF tranne l'adattatore WCF-NetNamedPipe

ReferencedBindings

Specificare le configurazioni di associazione a cui fa riferimento l'attributo bindingConfiguration dell'elemento <autorità di certificazione> per wsFederationHttpBinding e customBinding, che indica il servizio token di sicurezza (STS) che rilascia token di sicurezza. Per altre informazioni sull'elemento emittente, vedere l'argomento <"autorità emittente>>" in https://go.microsoft.com/fwlink/?LinkId=83476.<

Le informazioni di associazione, incluso l'elemento autorità di certificazione> per wsFederationHttpBinding e customBinding, possono essere configurate tramite la< proprietà BindingConfiguration delle schede di WCF-Custom e WCF-CustomIsolated. Tutte le configurazioni di associazione a cui si fa riferimento per questa proprietà devono essere inserite sotto forma di <elemento binding.>

Nota

L'attributo bindingConfiguration dell'elemento <emittente> deve fare riferimento a un nome di associazione valido in questa proprietà.

Nota

L'elemento <emittente> nelle configurazioni di associazione a cui si fa riferimento può fare riferimento anche a una configurazione di associazione diversa in questa proprietà se questa catena di riferimento non effettua una dipendenza circolare.

Esempio:

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 proprietà ReferencedBinding non deve contenere la configurazione dell'associazione usata nella proprietà BindingConfiguration .

Tipo: Valore predefinito stringa: una stringa vuota Si applica a: adattatore WCF-Custom, adattatore WCF-CustomIsolated

Vedere anche

Comportamento> degli adattatori<WCF delle associazioni endpointBehaviors del <servizioBehaviors><Recapito ordinato di messaggi bilanciamento del carico><><>