JoinBlock<T1,T2,T3>.ISourceBlock<Tuple<T1,T2,T3>>.ReserveMessage Méthode
Définition
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.
Réserve le droit de passer la propriété du message identifié par le DataflowMessageHeader de ce ISourceBlock<TOutput> au ITargetBlock<TInput>.
virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2,T3>>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<Tuple<T1, T2, T3> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<Tuple<T1, T2, T3> ^>::ReserveMessage;
bool ISourceBlock<Tuple<T1,T2,T3>>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<Tuple<T1,T2,T3>> target);
abstract member System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2,T3>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2 * 'T3> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2,T3>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2 * 'T3> -> bool
Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Tuple(Of T1, T2, T3))) As Boolean Implements ISourceBlock(Of Tuple(Of T1, T2, T3)).ReserveMessage
Paramètres
- messageHeader
- DataflowMessageHeader
DataflowMessageHeader du message qui doit être réservé.
- target
- ITargetBlock<Tuple<T1,T2,T3>>
ITargetBlock<TInput> pour lequel le message doit être réservé.
Retours
true
si le message a été réservé avec succès ; sinon false
.
Implémente
Exceptions
messageHeader
n'est pas valide.
target
est null
(Nothing en Visual Basic).
Remarques
Pour ITargetBlock<TInput> lequel le message doit être réservé n’a pas besoin d’être lié à partir de cette ISourceBlock<TOutput> instance. De plus, cette ISourceBlock<TOutput> instance n’a peut-être jamais offert le message directement au ITargetBlock<TInput>.
Si true
elle est retournée, vous devez ensuite appeler ConsumeMessage ou ReleaseReservation pour ce message avec le même DataflowMessageHeader message et ITargetBlock<TInput>. Si ce n’est pas le cas, la source peut ne pas être en mesure de propager d’autres messages vers n’importe quelle cible.
N’appelez ReserveMessage pas 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.