BufferBlock<T>.ISourceBlock<T>.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.
Appelé par un lié ITargetBlock<TInput> à réserver un précédemment offert DataflowMessageHeader 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> -> boolFunction ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T)) As Boolean Implements ISourceBlock(Of T).ReserveMessageParamètres
- messageHeader
- DataflowMessageHeader
Message DataflowMessageHeader réservé.
- target
- ITargetBlock<T>
ITargetBlock<TInput> Réservation du message.
Retours
true si le message a été correctement réservé ; sinon, false.
Implémente
Exceptions
L’objet messageHeader n’est pas valide.
target a la valeur null.
Remarques
Seules ITargetBlock<TInput> les 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. Si vous ne le faites pas, la source ne peut pas propager d’autres messages à cette ou à d’autres cibles.
ReserveMessage ne doit pas être appelé pendant que la cible contient des verrous internes. Cela enfreint la hiérarchie de verrous nécessaire pour éviter les blocages dans un réseau de flux de données.
