ValueTask<TResult> Yapı

Tanım

generic <typename TResult>
public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask<TResult>>

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

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

type ValueTask<'Result> = struct

Public Structure ValueTask(Of TResult)
Implements IEquatable(Of ValueTask(Of TResult))

Tür Parametreleri

Devralma

Object

ValueType

ValueTask<TResult>

Uygulamalar

IEquatable<ValueTask<TResult>>

Açıklamalar

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

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

• Örneği birden çok kez bekliyor.
• Birden çok kez arama AsTask .
• İşlem .Result henüz tamamlanmadığında veya .GetAwaiter().GetResult() kullanma ya da bunları birden çok kez kullanma.
• Örneği kullanmak için bu tekniklerden birden fazlasını kullanma.

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

Bir yöntem, işleminin sonucunun zaman uyumlu olarak kullanılabilir olma olasılığı yüksek olduğunda ve her çağrı için yeni Task<TResult> ayırma maliyetinin çok sık çağrılması beklendiğinde bu değer türünün bir örneğini döndürebilir.

yerine bir ValueTask<TResult>Task<TResult>kullanmanın dezavantajları vardır. Örneğin, başarılı sonucun zaman uyumlu olarak kullanılabilir olması durumunda ayırmayı ValueTask<TResult> önlemeye yardımcı olabilir, ancak başvuru türü olarak tek bir alan olan Task<TResult> birden çok alan da içerir. Bu, bir ValueTask<TResult> yöntemden döndürülerek daha fazla veri kopyalanması anlamına gelir. Ayrıca, bir döndüren ValueTask<TResult> bir yöntem zaman uyumsuz bir yöntem içinde bekleniyorsa, tek bir başvuru yerine birden çok alan içeren bir yapı depolaması gerektiğinden, bu zaman uyumsuz yöntemin durum makinesinin daha büyük olacağı anlamına gelir.

Await kullanarak zaman uyumsuz bir işlemin sonucunu kullanmak dışında kullanımlar için, ValueTask<TResult> daha fazla ayırma gerektiren daha karmaşık bir programlama modeline yol açabilir. Örneğin, ortak bir sonuç olarak önbelleğe alınmış göreve sahip bir veya döndürebilen Task<TResult> bir ValueTask<TResult>yöntem düşünün. Sonucun tüketicisi bunu veya WhenAnygibi WhenAll bir yöntemde kullanmak istiyorsa, ValueTask<TResult> ilk olarak Task<TResult> kullanarak AsTaskdeğerine dönüştürülmesi Task<TResult> gerekir ve bu da önbelleğe alınmış Task<TResult> bir yöntem kullanılmışsa önlenecek bir ayırmaya yol açar.

Bu nedenle, herhangi bir zaman uyumsuz yöntem için varsayılan seçenek veya TaskTask<TResult>döndürmek olmalıdır. Yalnızca performans analizi işe yararsa yerine bir ValueTask<TResult> kullanılması Task<TResult>gerekir. Genel olmayan sürümü ValueTask çoğu senaryo için önerilmez. özelliği, 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