<contrattoCom>

Articolo
02/27/2011

Specifica un contratto del servizio COM+ Integration.

Gerarchia dello schema

Sintassi

<comContracts>
  <comContract
      contract="string"
      namespace="string"
      name="string"
      requireSession="Boolean">
      <exposedMethods>
         <exposedMethod name="string" />
      </exposedMethods>
      <userDefinedTypes>
         <userDefinedType name="string"
            typeLibID="string"
            typeLibVersion="string"
            typeDefID="string">
         </userDefinedType>
      </userDefinedTypes>
      <persistableTypes>
         <persistableType id="string"
            name="string">
         </persistableType>
      </persistableTypes>
  </comContract>
</comContracts>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
contratto	Stringa che contiene il tipo di contratto.
name	Stringa che contiene il nome del contratto.
namespace	Stringa che contiene lo spazio dei nomi del contratto.
requiresSession	Valore booleano che specifica se il contratto può essere utilizzato solo nelle associazioni con sessione. All'avvio del servizio, il runtime di integrazione verifica che questa impostazione sia coerente con il tipo di associazione da utilizzare. Viene generata un'eccezione se una o più delle associazioni per il contratto sono in conflitto tra loro. Se questa proprietà è false e viene utilizzato un canale unidirezionale in presenza di parametri [out], viene generata un'eccezione.

Elementi figlio

Elemento	Descrizione
persistableTypes	Tutti i tipi persistenti.
userDefinedTypes	Raccolta di tipi definiti dall'utente che deve essere inclusa nel contratto di servizio.
exposedMethods	Raccolta di metodi COM+ che vengono esposti quando l'interfaccia in un componente COM+ viene esposta come servizio Web.

Elementi padre

Elemento	Descrizione
comContracts	Contiene una raccolta di elementi comContract.

Osservazioni

I contratti del servizio COM+ Integration sono limitati attualmente allo spazio dei nomi "http://tempuri.org" e il nome del contratto è derivato dall'interfaccia COM di supporto. È tuttavia possibile specificare alternative utilizzando la sezione comContracts e anche l'elemento comContract nel file di configurazione. Ad esempio, è possibile utilizzare la configurazione seguente per specificare lo spazio dei nomi, il nome del contratto, i tipi definiti dall'utente da includere e altre impostazioni per un contratto di servizio.

<comContracts>
  <comContract
      contract="{5163B1E7-F0CF-4B6A-9A02-4AB654F34284}"
      namespace="http://tempuri.org/5163B1E7-F0CF-4B6A-9A02-4AB654F34284"
      name="_Broker"
      requireSession="true">
      <exposedMethods>
         <exposedMethod name="BuyStock" />
         <exposedMethod name="SellStock" />
         <exposedMethod name="ExecuteTransaction" />
      </exposedMethods>
  </comContract>
</comContracts>

Quando il servizio viene inizializzato, gli spazi dei nomi specificati e i nomi del contratto vengono applicati alle descrizioni del servizio generate.

Vedere anche

Riferimento

ComContractElementCollection
ComContractElementCollection
ComContractElement

Concetti

Altre risorse

Integrating with COM+ Applications
How to: Configure COM+ Service Settings

Condividi tramite