ActivityDesigner Receive

L'ActivityDesigner Receive viene utilizzato per creare e configurare un'attività Receive. Un'attività Receive è un'attività che riceve un messaggio che può essere un tipo incorporato, quale Message, Stream o XElement, o una classe XML, un contratto dati o un contratto di messaggio serializzabile definito dall'applicazione.

Attività Receive

L'attività Receive può ricevere un solo elemento o più elementi a seconda del tipo di contenuto di ricezione utilizzato. È possibile associare un'attività SendReply a un'attività Receive che riceve un messaggio come parte di un modello di scambio di messaggi di richiesta/risposta nel servizio.

Utilizzo dell'ActivityDesigner Receive

L'ActivityDesigner Receive è disponibile nella categoria Messaggi della Casella degli strumenti, accessibile facendo clic sulla scheda Casella degli strumenti in Progettazione flussi di lavoro. In alternativa, scegliere Barra degli strumenti dal menu Visualizza o premere CTRL+ALT+X.

È possibile trascinare l'ActivityDesigner Receive dalla Casella degli strumenti e rilasciarlo nell'area di Progettazione flussi di lavoro, nel punto in cui vengono in genere posizionate le attività. In questo modo viene creata un'attività Receive con la proprietà DisplayName impostata sul valore predefinito Receive. È possibile modificare il valore di DisplayName nell'intestazione dell'ActivityDesigner Receive o nella casella DisplayName della griglia delle proprietà.

Per creare un'attività SendReply e associarla all'attività Receive selezionata, fare clic con il pulsante destro del mouse sull'ActivityDesigner Receive e scegliere l'elemento Crea SendReply nel menu di scelta rapida. La finestra di progettazione SendReplyToReceive verrà visualizzata sotto la finestra di progettazione Receive. L'attività SendReply è un'attività che invia il messaggio di risposta come parte di un modello di scambio di messaggi di richiesta/risposta nel servizio. È possibile configurarla mediante la finestra di progettazione SendReplyToReceive.

In alternativa, è possibile utilizzare la finestra di progettazione del modello ReceiveAndSendReply nella categoria Messaggi della Casella degli strumenti per creare una coppia di attività Receive e SendReply preconfigurate. Per ulteriori informazioni su sull'utilizzo dei modelli ReceiveAndSendReply e SendReplyToReceive, vedere l'argomento Finestra di progettazione del modello ReceiveAndSendReply.

Proprietà dell'attività Receive

Nella tabella seguente sono elencate le proprietà di Receive e ne viene descritta la modalità di utilizzo nella finestra di progettazione. Tali proprietà possono essere modificate nella griglia delle proprietà o nell'area di Progettazione flussi di lavoro. L'unica proprietà obbligatoria è la proprietà OperationName.

Nome proprietà	Obbligatoria	Utilizzo
DisplayName	False	Specifica il nome descrittivo dell'attività Receive. Il valore predefinito è Receive. Sebbene non sia obbligatorio specificare un valore non predefinito per la proprietà descrittiva DisplayName, è consigliabile farlo.
OperationName	True	Specifica il nome dell'operazione del servizio implementata da questa attività Receive. Questa proprietà viene utilizzata per costruire il valore predefinito della proprietà Action, se la proprietà Action non viene impostata in modo esplicito.
ServiceContractName	False	Specifica il nome del contratto di servizio. Questa proprietà viene utilizzata per raggruppare operazioni del servizio in contratti di servizio singoli. Tutte le attività Receive con lo stesso ServiceContractName vengono raggruppate nello stesso contratto di servizio (tipo di porta WSDL). Il valore predefinito è il nome CLR completo dell'attività di livello superiore (radice).
Content	False	Specifica il contenuto del messaggio o del parametro da ricevere. Può essere un'attività ReceiveMessageContent o un'attività ReceiveParametersContent. Modificare questa proprietà facendo clic sul pulsante con i puntini di sospensione accanto al campo Content nella griglia delle proprietà o facendo clic sul pulsante Definisci accanto all'etichetta Content nell'area dell'ActivityDesigner Receive. In entrambi i casi verrà visualizzata la finestra di dialogo Definizione contenuto. Per ulteriori informazioni su come utilizzare questa finestra, vedere l'argomento Finestra di dialogo Definizione contenuto.
CorrelatesOn	False	Specifica le correlazioni tra le attività Receive nelle operazioni del servizio di un flusso di lavoro con un oggetto MessageQuerySet. Fare clic sul pulsante con i puntini di sospensione accanto alla proprietà CorrelatesOn nella griglia delle proprietà per aprire la finestra di dialogo Definizione di CorrelatesOn. Per ulteriori informazioni su utilizzo di questa finestra di dialogo, vedere l'argomento Finestra di dialogo Definizione contenuto.
CorrelatesWith	False	Specifica l'oggetto CorrelationHandle utilizzato per indirizzare il messaggio all'istanza del flusso di lavoro appropriata. Fare clic sul pulsante con i puntini di sospensione accanto alla proprietà CorrelatesWith nella griglia delle proprietà per aprire la finestra di dialogo Editor espressioni. Per ulteriori informazioni su utilizzo di questa finestra di dialogo, vedere l'argomento Procedura: utilizzare l'editor espressioni.
CorrelationInitializers	False	Specifica la raccolta di oggetti CorrelationInitializer che inizializzano più oggetti CorrelationHandle che configurano questa attività Receive all'interno del flusso di lavoro. Fare clic sul pulsante con i puntini di sospensione accanto alla proprietà CorrelationInitializers nella griglia delle proprietà per aprire la finestra di dialogo Aggiungi inizializzatori di correlazione. Per ulteriori informazioni su come utilizzare questa finestra, vedere l'argomento Finestra di dialogo Aggiungi inizializzatori di correlazione.
CanCreateInstance	False	Specifica un valore che determina se viene creata una nuova istanza del flusso di lavoro per elaborare il messaggio se quest'ultimo non è correlato a un'istanza del flusso di lavoro esistente. Se il valore è impostato su true, l'istanza viene creata.
KnownTypes	False	Specifica una raccolta di tipi noti per l'operazione del servizio implementata da questa attività Receive. Questa proprietà deve essere utilizzata insieme alla proprietà SerializerOption impostata su DataContractSerializer. Viene ignorata se viene utilizzato XmlSerializer. Fare clic sul pulsante con i puntini di sospensione accanto al campo KnownTypes nella griglia delle proprietà per visualizzare la finestra di dialogo Editor raccolta di tipi in cui è possibile aggiungere i tipi appropriati. Per ulteriori informazioni su utilizzo di questa casella, vedere l'argomento Finestra di dialogo Editor raccolta di tipi.
ProtectionLevel	False	Specifica il tipo di ProtectionLevel applicato al messaggio. None indica che viene applicata solo l'autenticazione. Sign indica che i dati vengono firmati per garantirne l'integrità durante la trasmissione. EncryptAndSign indica che i dati vengono crittografati e firmati per garantirne la riservatezza e l'integrità durante la trasmissione.
SerializerOption	False	Specifica il tipo di serializzatore da utilizzare per l'operazione del servizio implementata dall'attività Receive. Il valore predefinito è DataContractSerializer, che serializza e deserializza un'istanza di un tipo in un documento o un flusso XML che utilizza un contratto dati fornito. È inoltre possibile utilizzare XmlSerializer se è richiesto un maggiore controllo sul codice XML.
Action	False	Specifica l'intestazione Action del messaggio. Se non viene impostata in modo esplicito, assume il valore predefinito: `https://tempuri.org/{spazio dei nomi contratto di servizio}/{nome contratto di servizio}/{nome operazione}`.

Vedere anche

Concetti

ActivityDesigner InitializeCorrelation
ActivityDesigner CorrelationScope
Finestra di progettazione del modello ReceiveAndSendReply
ActivityDesigner Send
Finestra di progettazione del modello SendAndReceiveReply
ActivityDesigner TransactedReceiveScope

Last updated on 2011-02-27