ISourceBlock<TOutput>.ReserveMessage Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A program meghívja a korábban a jelen szolgáltatás által kínált ITargetBlock<TInput> foglaláshoz kapcsolódó hivatkozással.DataflowMessageHeaderISourceBlock<TOutput>
public:
bool ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target);public bool ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target);abstract member ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> boolPublic Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput)) As BooleanParaméterek
- messageHeader
- DataflowMessageHeader
A DataflowMessageHeader fenntartott üzenet.
- target
- ITargetBlock<TOutput>
Az ITargetBlock<TInput> üzenet megőrzése.
Válaszok
trueha az üzenet lefoglalása sikeresen megtörtént; egyéb esetben. false
Kivételek
Érvénytelen messageHeader .
Az target van null.
Megjegyzések
Csak ITargetBlock<TInput> az ehhez ISourceBlock<TOutput> a példányhoz társított példányok használhatók ReserveMessage, és csak a forrás által korábban a célnak kínált példányok lefoglalására DataflowMessageHeader használhatók.
Ha true a rendszer visszaadja, a rendszer ezt ITargetBlock<TInput> követően hívja meg vagy ConsumeMessageReleaseReservation hívja meg az üzenetet. Ennek elmulasztása azt eredményezheti, hogy a forrás nem tudja propagálja a további üzeneteket erre vagy más célokra.
ReserveMessage nem hívható meg, amíg a cél belső zárat tart. Ha így tesz, azzal megsérti az adatfolyam-hálózat holtpontok elkerüléséhez szükséges zárolási hierarchiát.
