Bir yöntem adında "Async" sonekinin kullanımı, "zaman uyumsuz" değiştiricisinin kullanılıp kullanılmadığına bağlı mı?

Yöntem adlarının "Async" ile son eklenmesi için kural nedir?

"Async" soneki yalnızcaasync değiştiriciyle bildirilen bir yönteme eklenmeli mi?

public async Task<bool> ConnectAsync()

Yoksa yöntem sadece döner yeterli mi Task<T>yoksa Task?

public Task<bool> ConnectAsync()

Microsoft belgelerinde bile gerçeğin belirsiz olduğunu düşünüyorum:

Visual Studio 2012 ve .NET Framework 4.5 ile atfedilir herhangi yöntemde async(anahtar kelime AsyncVisual Basic) bir asenkron metot olarak kabul ve C # ve Visual Basic derleyiciler gerekli dönüşümleri TAP kullanarak zaman uyumsuz yöntemini uygulamak yerine edilmektedir. Zaman uyumsuz bir yöntem, bir Taskveya bir Task<TResult>nesne döndürmelidir .

http://msdn.microsoft.com/en-us/library/hh873177(v=vs.110).aspx

Bu zaten doğru değil. İle herhangi bir yöntem asynceşzamansızdır ve sonra bir Taskveya Task<T>- döndürmesi gerektiğini söyler - bu, bir çağrı yığınının üstündeki yöntemler için doğru değildir, örneğin Button_Click, veya async void.

Elbette, kongrenin amacının ne olduğunu düşünmek zorundasın?

Bunu söyleyebiliriz Asynceki kongre yöntemi awaitable olan API kullanıcıya iletişim kurmaktır. Bir yöntemin beklenebilir olması Taskiçin, bir boşluk Task<T>için veya bir değer döndürme yöntemi için geri dönmesi gerekir ; bu, yalnızca ikincisine son eklenebileceği anlamına gelir Async.

Veya Asyncsonek kuralının, yöntemin hemen geri dönebileceğini, diğer işleri yapmak için mevcut iş parçacığını bırakıp potansiyel olarak yarışlara neden olabileceğini bildirmek olduğunu söyleyebilirsiniz .

Bu Microsoft doc alıntı diyor ki:

Kural olarak, Zaman uyumsuz veya zaman uyumsuz değiştiriciye sahip yöntemlerin adlarına "Zaman uyumsuz" eklersiniz.

http://msdn.microsoft.com/en-us/library/hh191443.aspx#BKMK_NamingConvention

Bu, kendi asenkron yöntemlerin geri dönen son eke Taskihtiyaç duyduğundan bahsetmiyor bile Async, sanırım hepimiz bunu yaptıklarında hemfikiriz.

Yani bu sorunun cevabı şunlar olabilir: ikisi de. Her iki durumda da, anahtar kelimeli Asyncyöntemlere eklemeniz gerekir asyncve bu dönüş Taskveya Task<T>.

Stephen Toub'dan durumu açıklamasını isteyeceğim.

Güncelleme

Ben de yaptım. Ve işte iyi adamımızın yazdığı:

Genel bir yöntem Görev döndürüyorsa ve doğası gereği zaman uyumsuzsa (her zaman tamamlanana kadar eşzamanlı olarak yürütüldüğü bilinen ancak yine de herhangi bir nedenle bir Görev döndüren bir yöntemin aksine), bir "Zaman uyumsuz" sonekine sahip olmalıdır. Kılavuz budur. Buradaki adlandırma ile birincil amaç, bir tüketiciye, çağrılan yöntemin muhtemelen tüm çalışmasını eşzamanlı olarak tamamlamayacağını çok açık hale getirmektir; elbette, işlevselliğin hem eşzamanlı hem de eşzamansız yöntemlerle ortaya çıktığı durumda, onları ayırt etmek için bir ad farkına ihtiyaç duyduğunuzda yardımcı olur. Yöntemin zaman uyumsuz uygulamasını nasıl başardığı, adlandırma için önemsizdir: derleyicinin yardımını toplamak için zaman uyumsuz / beklemenin kullanılıp kullanılmadığı veya System.Threading.Tasks'ten türlerin ve yöntemlerin doğrudan kullanılıp kullanılmadığı (örn. g. TaskCompletionSource), yöntemin tüketicisi söz konusu olduğunda yöntemin imzasını etkilemediği için gerçekten önemli değildir.

Tabii ki, bir kılavuzun her zaman istisnaları vardır. Adlandırma durumunda en dikkate değer olanı, tüm bir türün varoluş nedeninin eşzamansız odaklı işlevsellik sağlamak olduğu durumlar olacaktır; bu durumda, her yöntemde Async'e sahip olmak aşırı olacaktır, örneğin, diğer Görevleri üreten Görevin kendisindeki yöntemler .

Boşluk geri dönüşlü eşzamansız yöntemlere gelince, arayan kişinin eşzamansız çalışmanın ne zaman tamamlandığını bilmesinin iyi bir yolu olmadığından, bunların kamuya açık yüzey alanında olması arzu edilmez. Boşluk döndüren bir eşzamansız yöntemi herkese açık olarak ifşa etmeniz gerekiyorsa, büyük olasılıkla eşzamansız çalışmanın başlatıldığını bildiren bir ada sahip olmak istersiniz ve mantıklıysa burada "Eşzamansız" sonekini kullanabilirsiniz. Bu davanın ne kadar nadir olması gerektiği göz önüne alındığında, bunun gerçekten duruma göre bir karar olduğunu düşünüyorum.

Umarım yardımcı olur Steve

Stephen'ın açılış cümlesindeki kısa ve öz rehber yeterince açık. Hariç tutuyor async voidçünkü böyle bir tasarıma sahip genel bir API yaratmak istemenin olağandışı bir durumdur çünkü zaman uyumsuz bir boşluğu uygulamanın doğru yolu düz bir Taskörnek döndürmek ve derleyicinin büyüsüne izin vermektir. Ancak, eğer a public async voidistediyseniz, o zaman eklemeniz Asyncönerilir. async voidOlay işleyicileri gibi diğer yığın üstü yöntemler genellikle herkese açık değildir ve önemli değildir / nitelendirilmez.

Benim için kendimi son eklemeli merak bulursanız söylüyor Asyncbir de async void, muhtemelen bir çevirmek gerekir async Tasksonra ekleme arayanlar bunu bekliyor böylece Async.

Kodumun çoğunun eşzamansız olarak çalıştığı diğer sistemleri çağıran çok sayıda API hizmetleri ve başka uygulamalar oluşturuyorum.

Takip ettiğim kendi genel kuralım:

Aynı şeyi döndüren hem eşzamansız hem de zaman uyumsuz yöntem varsa, zaman uyumsuz olanı Zaman uyumsuz olana eklerim. Aksi takdirde değil.

Örnekler:

Yalnızca bir yöntem:

public async Task<User> GetUser() { [...] }

İki imzayla aynı yöntem:

public User GetUser() { [...] }

public async Task<User> GetUserAsync() { [...] }

Bu mantıklıdır, çünkü döndürülen verilerle aynıdır, ancak farklı olan tek şey verilerin kendisi değil, verilerin döndürülme şeklidir .

Ayrıca, bu adlandırma kurallarının, zaman uyumsuz yöntemler sunma ve hala geriye dönük uyumluluğu sürdürme ihtiyacı nedeniyle var olduğunu düşünüyorum.

Yeni kodun Async sonekini kullanmaması gerektiğini savunuyorum. Bu iş parçacığında daha önce belirtildiği gibi String veya Int türünün dönüş türü kadar açıktır.

Yöntem adlarının "Async" ile son eklenmesi için kural nedir.

Görev tabanlı zaman uyumsuz Desen (TAP) yöntemleri her zaman döndürmesi gerektiğini dikte Task<T>(veya Task) ve ile adlandırılacak zaman uyumsuz soneki; bu kullanımdan ayrıdır async. Hem Task<bool> Connect()ve derlemek ve sadece iyi çalıştırmak, ancak TAP adlandırma kuralı aşağıdaki olmayacaktır olacaktır.asyncTask<bool> Connect()

Yöntem asyncdeğiştiriciyi içermeli mi yoksa sadece Task'ı döndürmesi için yeterli mi?

Yöntemin gövdesi (dönüş türü veya adı ne olursa olsun) içeriyorsa await, kullanmanız gerekirasync ; ve derleyici size "'await' operatörü yalnızca zaman uyumsuz bir yöntem içinde kullanılabilir. ..." diyecektir. Geri dönmek Task<T>veya Taskkullanmaktan kaçınmak için "yeterli" değil async. Ayrıntılar için eşzamansız (C # Başvurusu) bölümüne bakın .

Yani bu imzalardan hangisi doğru:

Her ikisi de ve TAP kurallarına uygun şekilde uyun. Her zaman anahtar sözcüğü kullanabilirsiniz , ancak "Bu eşzamansız yöntem 'bekleme' işleçlerinden yoksundur ve gövde kullanmıyorsa eşzamanlı olarak çalışır. ..." şeklinde bir derleyici uyarısı alırsınız .asyncTask<bool> ConnectAsync()Task<bool> ConnectAsync()asyncawait

yoksa sadece Task'ı döndürmesi yeterli mi?

Bu. asyncBuradaki anahtar kelime asıl mesele değildir. Eşzamansızlığı asyncanahtar sözcüğü kullanmadan uygularsanız, yöntem genel anlamda hala " Eşzamansız " olur.

Yana Taskve Task<T>her ikisi awaitable tipleridir, temsil ettikleri bazı zaman uyumsuz işlem. Ya da en azından temsil etmeleri gerekir.

AsyncBazı durumlarda (tümü değil) bir değer döndürmeyen, bunun yerine devam eden bir işlemin etrafında bir sarmalayıcı döndüren bir yönteme sonek eklemelisiniz . Bu sarmalayıcı genellikle bir Task, ancak Windows RT'de olabilir IAsyncInfo. İçgüdülerinizi takip edin ve kodunuzun bir kullanıcısı Asyncişlevi görürse , o yöntemin çağrılmasının o yöntemin sonucundan ayrıldığını ve buna göre hareket etmeleri gerektiğini bileceğini unutmayın.

Dönen Task.Delayve Task.WhenAlldönen gibi yöntemler olduğunu Taskve henüz Asyncsonekin olmadığını unutmayın .

Ayrıca ateşiasync void temsil eden ve asenkron metodu unutan metotlar olduğunu ve metodun bu şekilde inşa edildiğini bilmelisiniz.

Yöntemin asyncdeğiştiriciyle bildirilip bildirilmediğine bakılmaksızın bir Task döndürürse Async sonekini kullanması gerektiğini iddia ediyorum .

Bunun arkasındaki sebep, ismin arayüzde beyan edilmesidir. Arayüz, bir dönüş türü olan bir Task. Sonra bu arayüzün iki uygulaması vardır, bir uygulama asyncdeğiştiriciyi kullanarak onu uygular , diğeri yapmaz.

public interface IFoo
{
    Task FooAsync();
}

public class FooA : IFoo
{
    public Task FooAsync() { /* ... */ }
}

public class FooB : IFoo
{
    public async Task FooAsync() { /* ... */ }
}

Gelen zaman uyumsuz ve asenkron programlama burada bekliyor (C #) , Microsoft aşağıdaki rehberlik sunmaktadır:

Adlandırma kuralı

Kural olarak, zaman uyumsuz değiştiriciye sahip yöntemlerin adlarına "Zaman uyumsuz" eklersiniz .

Bir olayın, temel sınıfın veya arabirim sözleşmesinin farklı bir ad önerdiği kuralı yok sayabilirsiniz. Örneğin, gibi genel olay işleyicilerini yeniden adlandırmamalısınız Button1_Click.

Bu kılavuzu eksik ve tatmin edici bulmuyorum. Bu, asyncdeğiştiricinin yokluğunda Connectbunun yerine bu yöntemin adlandırılması gerektiği anlamına mı geliyor ConnectAsync?

public Task<bool> ConnectAsync()
{
    return ConnectAsyncInternal();
}

Ben öyle düşünmüyorum. Belirtildiği gibi özlü cevap tarafından @Servy ve daha ayrıntılı cevap tarafından @Luke Puplett , Ben yöntem, uygun ve gerçekten de beklenen olduğuna inanıyoruz gerekir adlandırılacak ConnectAsync(bir awaitable döndürdüğü için). Bu daha da desteklenmesi kapsamında, @John Skeet içinde bu cevap başka soruya ekler Asyncbakılmaksızın varlığı yöntemi adının asyncdeğiştirici.

Son olarak, başka bir soruda , @Damien_The_Unbeliever tarafından yazılan bu yorumu düşünün :

async/awaityöntemlerinizin uygulama ayrıntılarıdır. Arayanlar söz konusu olduğu sürece, yönteminizin beyan edilmiş olması async Task Method()veya sadece tek bir not bile önemli değildir . (Aslında, bu ikisi arasında daha sonraki bir noktada, bir kırılma değişikliği olarak kabul edilmeden geçiş yapmakta özgürsünüz.)Task Method()

Bundan, nasıl adlandırılması gerektiğini belirleyen şeyin , yöntemin asenkron doğası olduğu sonucuna varıyorum . Yöntemin kullanıcısı, asyncdeğiştiricinin uygulamasında kullanılıp kullanılmadığını bile bilmeyecektir (C # kaynak kodu veya CIL olmadan).