BroadcastBlock<T>.ISourceBlock<T>.ReserveMessage Méthode

Référence

Définition

Espace de noms:: System.Threading.Tasks.Dataflow

Assembly:: System.Threading.Tasks.Dataflow.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Appelé par un ITargetBlock<TInput> lié pour réserver un DataflowMessageHeader précédemment proposé par ce ISourceBlock<TOutput>.

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<T> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<T>::ReserveMessage;

bool ISourceBlock<T>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<T> target);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T> -> bool

Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T)) As Boolean Implements ISourceBlock(Of T).ReserveMessage

Paramètres

messageHeader: DataflowMessageHeader

DataflowMessageHeader du message en cours de réservation.

target: ITargetBlock<T>

ITargetBlock<TInput> réservant le message.

Retours

Boolean

true si le message a été réservé avec succès ; sinon false.

Implémente

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

Exceptions

ArgumentException

messageHeader n'est pas valide.

ArgumentNullException

target a la valeur null.

Remarques

Seules les ITargetBlock<TInput> instances liées à cette ISourceBlock<TOutput> instance peuvent utiliser ReserveMessage, et elles doivent uniquement être utilisées pour réserver DataflowMessageHeader des instances précédemment proposées par cette source à la cible.

Si true elle est retournée, l’appel ITargetBlock<TInput> doit ensuite être appelé ConsumeMessage ou ReleaseReservation pour ce message. L’échec de cette opération peut entraîner l’impossibilité de propager d’autres messages vers cette ou d’autres cibles.

ReserveMessage ne doit pas être appelé pendant que la cible contient des verrous internes. Cela violera la hiérarchie de verrou nécessaire pour éviter les blocages dans un réseau de flux de données.

S’applique à

Partager via