ValueTask Yapı

Tanım

public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask>

public readonly struct ValueTask : IEquatable<System.Threading.Tasks.ValueTask>

type ValueTask = struct

Public Structure ValueTask
Implements IEquatable(Of ValueTask)

Devralma

Object

ValueType

ValueTask

Uygulamalar

IEquatable<ValueTask>

Açıklamalar

Bir ValueTask örnek beklenebilir veya kullanılarak AsTasköğesine Task dönüştürülebilir. Bir ValueTask örnek yalnızca bir kez beklenebilir ve tüketiciler örnek tamamlanana kadar çağıramayabilir GetAwaiter() . Bu sınırlamalar kabul edilemezse çağrısı AsTaskyaparak öğesini ValueTask değerine Task dönüştürün.

Aşağıdaki işlemler hiçbir zaman bir ValueTask örnekte gerçekleştirilmemelidir:

• Örneği birden çok kez bekliyor.
• Birden çok kez arama AsTask .
• Örneği kullanmak için bu tekniklerden birden fazlasını kullanma.

Yukarıdakilerden birini yaparsanız sonuçlar tanımlanmamış olur.

A ValueTask , veya örneğini sarmalayan Task bir IValueTaskSource yapıdır. Zaman uyumsuz bir ValueTask yöntemden bir IValueTaskSource örneği sarmalayan bir döndürülmesi, yüksek aktarım hızına sahip uygulamaların yeniden kullanılabilir IValueTaskSource nesne havuzu kullanarak ayırmaları önlemesini sağlar. Daha fazla bilgi için bkz. ValueTask'in Nedenlerini, Neleri ve Ne Zamanlarını Anlama.

yerine a ValueTaskTask kullanmak bazı ek yük getirir. ValueTask Birden çok alanı olan bir yapı olduğundan, bunu yöntemden döndürmek, tek Task bir başvuru döndürmeye kıyasla daha fazla veri kopyalamayla sonuçlanır. Bu nedenle, sonuç döndürmeyen herhangi bir zaman uyumsuz yöntem için varsayılan seçenek bir Taskdöndürmek olmalıdır. Yalnızca performans analizi işe yararsa yerine bir ValueTask kullanılması Taskgerekir. özelliği, Task.CompletedTask bir yöntemi döndüren bir yöntemin zaman uyumlu ve başarılı bir şekilde tamamlanması durumunda başarıyla tamamlanmış bir Task singletonu geri vermek için kullanılmalıdır.

Oluşturucular

Özellikler

Yöntemler

İşleçler

Şunlara uygulanır