Come usare tipi di messaggi in più parti

Ogni messaggio ha un tipo di messaggio in più parti, una descrizione della struttura del messaggio costituita da zero o più parti del messaggio. Le parti sono definite da schemi del linguaggio XSD (XML Schema Definition) o classi .NET. È possibile definire tipi di messaggio in più parti oppure usare classi e schemi .NET esistenti.

È possibile accedere o assegnare parti di messaggio direttamente all'interno dell'orchestrazione oppure è possibile usare singoli elementi di parti del messaggio esposte come campi distinti o campi delle proprietà. Per altre informazioni, vedere Uso di campi distinti e proprietà del messaggio.

Annotazioni

Un tipo di messaggio in più parti non contiene necessariamente più parti.

Annotazioni

Una parte del messaggio può essere definita dal tipo XmlDocument .NET, che può essere usato per contenere un documento XML arbitrario, da qualsiasi tipo .NET serializzabile xml o da qualsiasi tipo .NET che supporta la serializzazione personalizzata.

Aggiungere un tipo di messaggio in più parti

1. Nella finestra Visualizzazione orchestrazione espandere il nodo Tipi .

2. Fare clic con il pulsante destro del mouse su Tipi di messaggi in più parti e quindi scegliere Nuovo tipo di messaggio in più parti.

   La cartella Tipi di messaggi in più parti si espande, se compressa e viene aggiunto un nuovo tipo di messaggio in più parti con una parte di messaggio predefinita.

3. Assegnare un nome al tipo di messaggio in più parti e alla parte del messaggio specificata.

   Se il tipo di messaggio in più parti richiede più di una parte del messaggio, è possibile aggiungere altre parti assegnando un nome alla <parte Nuovo> messaggio.

4. Associare ogni parte del messaggio a un tipo, ad esempio una classe o uno schema .NET.

Rimuovere un tipo di messaggio in più parti

• Nella finestra Visualizzazione orchestrazione fare clic con il pulsante destro del mouse sul tipo di messaggio in più parti da rimuovere e quindi scegliere Elimina.

  Annotazioni

  La rimozione di un tipo di messaggio in più parti dall'orchestrazione rimuoverà anche le informazioni sul tipo dai messaggi che lo usano.

  Annotazioni

  Gli elementi visualizzati come di sola lettura sono definiti in un'altra orchestrazione.

Rimuovere una parte da un tipo di messaggio in più parti

• Nella finestra Visualizzazione orchestrazione fare clic con il pulsante destro del mouse sulla parte da rimuovere e scegliere Elimina.

  Annotazioni

  Non è possibile eliminare la parte del messaggio di un tipo di messaggio se la proprietà Message Body Part è impostata su true. È innanzitutto necessario impostare la proprietà Message Body Part su True per un'altra delle parti del tipo di messaggio.

Impostare il modificatore di tipo per un tipo di messaggio in più parti

• Nella finestra Proprietà impostare la proprietà seguente:

  Proprietà	Descrizione
  Modificatore di tipo	Determina l'ambito del tipo di messaggio in più parti: - Privato—L'accesso a questo tipo di messaggio in più parti è limitato al modulo contenitore. - Pubblico—L'accesso a questo tipo di messaggio in più parti non è limitato. - Interno:L'accesso a questo tipo di messaggio in più parti è limitato ai moduli all'interno dello stesso progetto.

Aggiungere parti a un messaggio in più parti esistente

• BizTalk Server consente di aggiungere parti a un messaggio XLANG in più parti e di fare riferimento a una parte del messaggio da un indice maggiore del numero di parti originariamente dichiarato se la parte esiste. Questa funzionalità può essere utile per l'invio o la ricezione di messaggi SMTP con un numero variabile di allegati. Questa funzionalità viene implementata nel modo seguente:

• Dal progetto aggiungere un riferimento a Microsoft.XLANGs.BaseTypes.

• Creare una variabile (ad esempio xlangPart) di tipo Microsoft.XLANGs.BaseTypes.XLANGMessage.

• Chiama xlangPart.AddPart(...) utilizzando gli argomenti appropriati da una forma di espressione.

  Annotazioni

  Le parti aggiunte sono di tipo XmlDocument, pertanto non è possibile aggiungere una parte del messaggio formattata personalizzata usando il metodo AddPart().

Annotazioni

Se viene ricevuto un messaggio in più parti che contiene un numero maggiore del numero di parti dichiarate, il motore di orchestrazione legge il numero di parti presenti nel messaggio, quindi costruisce i tipi di parte appropriati per le parti che corrispondono al numero di parti nel tipo di messaggio dichiarato e quindi costruisce le parti XmlDocument per le parti rimanenti.

Vedere anche

Metodo IBaseMessage.AddPart (COM) nelle indicazioni sull'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori
Risorse XSD sul Web
Utilizzo di campi distinti e campi delle proprietà
Uso dei messaggi nelle orchestrazioni