hızlı başlangıç: ASP.NET ve signalr hizmeti ile sohbet odası oluşturma

Azure signalr hizmeti, ASP.NET signalr ile %100 uyumlu olmayan ASP.NET Core 2,1 için signalr'yi temel alır. Azure signalr hizmeti, en son ASP.NET Core teknolojilerine göre signalr veri protokolü ASP.NET yeniden uygulandı. ASP.NET signalr için azure signalr hizmeti kullanılırken, bazı ASP.NET signalr özellikleri artık desteklenmez. örneğin, azure signalr, istemci yeniden bağlandığında iletileri yeniden oynamaz. Ayrıca, süresiz çerçeve taşıması 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 ve ASP.NET Core signalr arasındaki özellik karşılaştırmasının tamamen listesi için sürüm farklılıkları bölümüne bakın.

bu hızlı başlangıçta, benzer bir sohbet odası uygulamasıiçin ASP.NET ve Azure signalr hizmetini kullanmaya nasıl başlacağınızı öğ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 bilgi verin.

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 bilgi verin.

Azure SignalR Hizmeti örneği oluşturma

Uygulamanız Azure’da bir SignalR hizmeti örneğine bağlanır.

1. Azure portalın sol üst köşesinde bulunan Yeni düğmesini seçin. Yeni ekranda arama kutusuna SignalR hizmeti yazın ve Enter tuşuna basın.

   

2. Arama sonuçlarından SignalR Hizmeti’ni seçtikten sonra Oluştur’u seçin.

3. Aşağıdaki ayarları girin.

   Ayar	Önerilen değer	Açıklama
   Kaynak adı	Genel olarak benzersiz bir ad	Yeni SignalR Hizmeti örneğinizi tanımlayan ad. Geçerli karakterler: a-z, 0-9 ve -.
   Abonelik	Aboneliğiniz	Yeni SignalR Hizmeti örneğinin oluşturulacağı abonelik.
   Kaynak Grubu	myResourceGroup	SignalR Hizmeti örneğinizin oluşturulacağı yeni kaynak grubunun adı.
   Konum	Batı ABD	Size yakın bir bölge seçin.
   Fiyatlandırma katmanı	Ücretsiz	Azure SignalR Hizmetini ücretsiz deneyin.
   Birim sayısı	Uygulanamaz	Birim sayısı, SignalR Hizmeti örneğinizin kaç bağlantı kabul edebileceğini belirtir. Bu yalnızca Standart katmanda yapılandırılabilir.
   Hizmet modu	Sunucusuz	Azure Işlevleri veya REST API kullanmak için.

   

4. SignalR Hizmeti örneğini dağıtmaya başlamak için Oluştur’u seçin.

5. Örnek dağıtıldıktan sonra portalda açın ve ayarlar sayfasını bulun. Azure SignalR hizmetini Azure Işlevleri bağlama veya REST API aracılığıyla kullanıyorsanız, hizmet modu ayarını sunucusuz olarak değiştirin. Aksi halde Klasik veya varsayılan olarak bırakın.

sunucusuz mod, ASP.NET signalr uygulamaları için desteklenmez. Her zaman Azure SignalR hizmeti örneği için varsayılan veya Klasik ' i kullanın.

Bu hızlı başlangıçta, bir SignalR Hizmet betiği oluşturIle kullanılan Azure kaynakları da oluşturabilirsiniz.

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

Ö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 bilgi verin.

Sohbet odası Web uygulamasını yapılandırma ve çalıştırma

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

2. Azure portal 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ı dizesini ayarlayın.

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

6. Başlangıç. cs' de çağırmak yerine, MapSignalR() MapAzureSignalR({YourApplicationName}) uygulamanın kendi kendine bir SignalR barındırmak yerine hizmete bağlanmasını sağlamak için bağlantı dizesini çağırmanız ve geçirmeniz gerekir. {YourApplicationName}Uygulamanızın adıyla değiştirin. Bu ad, bu uygulamayı diğer uygulamalarınızdan ayırt etmek için benzersiz bir addır. Değer olarak ' i 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ı açın | NuGet Paket Yöneticisi | Paket Yöneticisi konsolu ve çalıştır komutu:

   Install-Package Microsoft.Azure.SignalR.AspNet
   

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

   Not

   Uygulamada, bir uç nokta /signalr/negotiate Azure SignalR hizmeti SDK 'sı tarafından anlaşmaya sunuldu. İstemciler bağlanmayı ve bağlantı dizesinde tanımlanan hizmet uç noktasına yeniden yönlendirmeyi denediğinde, ö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. Bir SignalR çalışma zamanını uygulamanın kendisi için barındırmak yerine artık Azure SignalR hizmetine bağlanır.

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

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ı’na tıklayın.

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 bilgi verin.

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. Daha sonra, ASP.NET Core ile Azure SignalR hizmetini kullanarak gerçek zamanlı uygulamalar geliştirmeyi öğrenin.