Hızlı Başlangıç: ASP.NET ve SignalR Hizmeti ile sohbet odası oluşturma

Azure SignalR HizmetiASP.NET SignalR ile %100 uyumlu olmayan ASP.NET Core 2.1 için SignalR. Azure SignalR Hizmeti, en son ASP.NET Core teknolojilerine göre SignalR veri protokolü ASP.NET yeniden ASP.NET. ASP.NET SignalR için Azure SignalR Hizmeti kullandığınızda bazı ASP.NET SignalR özellikleri artık desteklenmemektedir. Örneğin, istemci yeniden bağlandığında Azure SignalR iletileri yeniden yürütmez. Ayrıca, Forever Frame aktarımı ve JSONP desteklenmez. ASP.NET SignalR uygulamasının SignalR Hizmeti ile çalışmasını sağlamak için bazı kod değişiklikleri ve bağımlı kitaplıkların uygun sürümü gerekir.

ASP.NET SignalR ile ASP.NET Core SignalR arasındaki özellik karşılaştırmasının tam listesi için sürüm farklılıkları belgesine bakın.

Bu hızlı başlangıçta, benzer bir Sohbet Odası uygulaması için ASP.NET ve Azure SignalR Hizmeti kullanmaya başlamayı öğreneceksiniz.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

• Visual Studio 2019
• .NET Framework 4.6.1
• ASP.NET SignalR 2.4.1

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzunu deneyin veya bize bildirin.

Azure'da oturum açma

Azure hesabınızla Azure portalında oturum açın.

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzunu deneyin veya bize bildirin.

Bu bölümde, uygulamanız için kullanılacak temel bir Azure SignalR örneği oluşturacaksınız. Aşağıdaki adımlarda yeni bir örnek oluşturmak için Azure portalı kullanılır, ancak Azure CLI'yı da kullanabilirsiniz. Daha fazla bilgi için Azure SignalR Hizmeti CLI Başvurusu'ndaki az signalr create komutuna bakın.

1. Azure Portal oturum açın.
2. Sayfanın sol üst kısmında + Kaynak oluştur'u seçin.
3. Kaynak oluştur sayfasında, Arama hizmeti s ve market metin kutusuna signalr yazın ve listeden SignalR Hizmeti seçin.
4. SignalR Hizmeti sayfasında Oluştur'u seçin.
5. Temel Bilgiler sekmesinde, yeni SignalR Hizmeti örneğinin temel bilgilerini girersiniz. Aşağıdaki değerleri girin:

SignalR öğreticileri için Ağ ve Etiketler sekmelerindeki ayarları değiştirmeniz gerekmez.

6. Temel Bilgiler sekmesinin en altındaki Gözden Geçir + oluştur düğmesini seçin.
7. Gözden geçir ve oluştur sekmesinde değerleri gözden geçirin ve Oluştur'u seçin. Dağıtımın tamamlanması birkaç dakika sürer.
8. Dağıtım tamamlandığında Kaynağa git düğmesini seçin.
9. SignalR kaynağı sayfasında, soldaki menüden Ayarlar altında Anahtarlar'ı seçin.
10. Birincil anahtar için Bağlan ion dizesini kopyalayın. Bu öğreticinin ilerleyen bölümlerinde uygulamanızı yapılandırmak için bu bağlantı dizesi gerekir.

Sunucusuz mod, ASP.NET SignalR uygulamaları için desteklenmez. Azure SignalR Hizmeti örneği için her zaman Varsayılan veya Klasik kullanın.

Bu hızlı başlangıçta kullanılan Azure kaynaklarını SignalR Hizmeti betiği oluştur ile de oluşturabilirsiniz.

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzunu deneyin veya bize bildirin.

Örnek uygulamayı kopyalama

Hizmet dağıtılırken kod ile çalışmaya geçiş yapalım. GitHub'dan örnek uygulamayı kopyalayın, SignalR Hizmetinin bağlantı dizesini ayarlayın ve uygulamayı yerel olarak çalıştırın.

1. Bir git terminal penceresi açın. Örnek projeyi kopyalamak istediğiniz klasöre gidin.

2. Örnek depoyu kopyalamak için aşağıdaki komutu çalıştırın. Bu komut bilgisayarınızda örnek uygulamanın bir kopyasını oluşturur.

   git clone https://github.com/aspnet/AzureSignalR-samples.git
   

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzunu deneyin veya bize bildirin.

Sohbet Odası web uygulamasını yapılandırma ve çalıştırma

1. Visual Studio'yu başlatın ve çözümü kopyalanan deponun aspnet-samples/ChatRoom/ klasöründe açın.

2. Azure portalının açıldığı tarayıcıda oluşturduğunuz örneği bulun ve seçin.

3. SignalR Hizmeti örneğinin bağlantı dizelerini görüntülemek için Anahtarlar’ı seçin.

4. Birincil bağlantı dizesini seçerek kopyalayın.

5. Şimdi web.config dosyasında bağlantı dizesi ayarlayın.

   <configuration>
   <connectionStrings>
       <add name="Azure:SignalR:ConnectionString" connectionString="<Replace By Your Connection String>"/>
   </connectionStrings>
   ...
   </configuration>
   

6. Startup.cs dosyasında çağırmak MapSignalR()yerine çağrısı yapmanız MapAzureSignalR({YourApplicationName}) ve bağlantı dizesi geçirerek uygulamanın SignalR'yi tek başına barındırmak yerine hizmete bağlanmasını sağlamanız gerekir. değerini uygulamanızın adıyla değiştirin {YourApplicationName} . Bu ad, bu uygulamayı diğer uygulamalarınızdan ayırt etmek için benzersiz bir addır. Değeri olarak kullanabilirsiniz this.GetType().FullName .

   public void Configuration(IAppBuilder app)
   {
       // Any connection or hub wire up and configuration should go here
       app.MapAzureSignalR(this.GetType().FullName);
   }
   

   Ayrıca bu API'leri kullanmadan önce hizmet SDK'sına başvurmanız gerekir. Araçlar | uygulamasını açma NuGet Paket Yöneticisi | konsolunu Paket Yöneticisi ve komutunu çalıştırın:

   Install-Package Microsoft.Azure.SignalR.AspNet
   

   Bu değişiklikler dışında, diğer her şey aynı kalır, iş mantığı yazmak için zaten bildiğiniz hub arabirimini kullanmaya devam edebilirsiniz.

   Dekont

   Uygulamada bir uç nokta/signalr/negotiate, Azure SignalR Hizmeti SDK tarafından anlaşma için kullanıma sunulur. İstemciler bağlanmaya ve bağlantı dizesi tanımlanan hizmet uç noktasına yeniden yönlendirmeye çalıştığında özel bir anlaşma yanıtı döndürür.

7. Projeyi hata ayıklama modunda çalıştırmak için F5 tuşuna basın. Uygulamanın yerel olarak çalıştığını görebilirsiniz. SignalR çalışma zamanını uygulamanın kendisine göre barındırmak yerine artık Azure SignalR Hizmeti bağlanıyor.

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzunu deneyin veya bize bildirin.

Kaynakları temizleme

Bu uygulamayı kullanmaya devam etmeyecekseniz, herhangi bir ücret ödememek için aşağıdaki adımları kullanarak bu hızlı başlangıç tarafından oluşturulan tüm kaynakları silin:

1. Azure portalında, en solda bulunan Kaynak grupları’nı ve ardından oluşturduğunuz kaynak grubunu seçin. Alternatif olarak kaynak grubunu adıyla bulmak için arama kutusunu kullanabilirsiniz.

2. Açılan pencerede kaynak grubunu seçin ve Kaynak grubunu sil’e tıklayın.

3. Yeni pencerede, silmek için kaynak grubunun adını yazıp Sil öğesine tıklayın.

Azure portalında oturum açın ve Kaynak grupları’nı seçin.

Ada göre filtrele... metin kutusuna kaynak grubunuzun adını girin. Bu hızlı başlangıçtaki yönergelerde SignalRTestResources adlı bir kaynak grubu kullanılmıştır. Sonuç listesindeki kaynak grubunuzda ... ve sonra Kaynak grubunu sil’e tıklayın.

Birkaç dakika sonra kaynak grubu ve içerdiği kaynakların tümü silinir.

Sorun mu yaşıyorsunuz? Sorun giderme kılavuzunu deneyin veya bize bildirin.

Sonraki adımlar

Bu hızlı başlangıçta yeni bir Azure SignalR Hizmeti kaynağı oluşturdunuz ve bunu bir ASP.NET web uygulamasıyla kullandınız. Ardından, ASP.NET Core ile Azure SignalR Hizmeti kullanarak gerçek zamanlı uygulamalar geliştirmeyi öğrenin.