ValueTask Yapı

Tanım

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

public 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 bir kullanımı beklemiş veya bir using öğesine dönüştürülebilir Task olabilir AsTask .A ValueTask instance may either be awaited or converted to a Task using AsTask. ValueTaskÖrnek yalnızca bir kez beklemiş olabilir ve müşteriler örnek tamamlanana kadar çağırmayabilir GetAwaiter() .A ValueTask instance may only be awaited once, and consumers may not call GetAwaiter() until the instance has completed. Bu sınırlamalar kabul edilemez ise, çağırarak öğesini ValueTask öğesine dönüştürün Task AsTask .If these limitations are unacceptable, convert the ValueTask to a Task by calling AsTask.

Aşağıdaki işlemler bir örnek üzerinde hiçbir şekilde gerçekleştirilmemelidir ValueTask :The following operations should never be performed on a ValueTask instance:

• Örnek birden çok kez bekleniyor.Awaiting the instance multiple times.
• AsTaskBirden çok kez çağırma.Calling AsTask multiple times.
• Örneği tüketmek için bu tekniklerden daha fazlasını kullanma.Using more than one of these techniques to consume the instance.

Yukarıdakilerden herhangi birini yaparsanız sonuçlar tanımsızdır.If you do any of the above, the results are undefined.

ValueTask, Bir Task veya örneğini kaydırabilirler IValueTaskSource .A ValueTask is a structure that can wrap either a Task or a IValueTaskSource instance. ValueTaskZaman uyumsuz bir yöntemden örnek kaydırılan bir döndürme, IValueTaskSource yeniden kullanılabilir nesneler havuzunu kullanarak ayırmalara engel olmak için yüksek performanslı uygulamalar sağlar IValueTaskSource .Returning a ValueTask that wraps a IValueTaskSource instance from an asynchronous method enables high-throughput applications to avoid allocations by using a pool of reusable IValueTaskSource objects. Daha fazla bilgi için bkz. Whys, yenilikleri ve ne zaman ValueTask.For more information, see Understanding the Whys, Whats, and Whens of ValueTask.

Yerine bir kullanmak ValueTask , Task bazı ek yük getirir.Using a ValueTask instead of a Task introduces some overhead. ValueTaskBirden çok alan içeren bir yapı olduğundan, yöntemin yönteminden döndürülmesi, tek bir başvurunun döndürülmesinden daha fazla veri kopyalamaya neden olur Task .Because ValueTask is a structure with multiple fields, returning it from the method results in copying more data compared to returning a single Task reference. Bu nedenle, sonuç döndürmeyen herhangi bir zaman uyumsuz metodun varsayılan seçimi bir döndürmelidir Task .As such, the default choice for any asynchronous method that does not return a result should be to return a Task. Yalnızca performans analizinin ValueTask bir yerine kullanılması gerektiğini kanıtlarken Task .Only if performance analysis proves it worthwhile should a ValueTask be used instead of a Task. Task.CompletedTaskÖzelliği, Task zaman uyumlu olarak ve başarılı bir şekilde bir şekilde döndürülen bir yöntemin başarıyla tamamlandığını geri almak için kullanılmalıdır.The Task.CompletedTask property should be used to hand back a successfully completed singleton in the case where a method returning a Task completes synchronously and successfully.

Oluşturucular

Özellikler

Yöntemler

İşleçler

Şunlara uygulanır