Öğretici: Visual Studio'da React ile ASP.NET Core uygulaması oluşturma

Makale
01/13/2024

Bu makalede, API arka ucu olarak hareket etmek için bir ASP.NET Core projesi oluşturmayı ve kullanıcı arabirimi olarak davranacak bir React projesi oluşturmayı öğreneceksiniz.

Visual Studio şu anda Angular ve React'i destekleyen ASP.NET Temel Tek Sayfalı Uygulama (SPA) şablonları içerir. Şablonlar, ASP.NET Core projelerinizde her çerçevenin temel dosyalarını ve klasörlerini içeren yerleşik bir İstemci Uygulaması klasörü sağlar.

Aşağıdaki ASP.NET Temel Tek Sayfalı Uygulamalar oluşturmak için bu makalede açıklanan yöntemi kullanabilirsiniz:

İstemci uygulamasını ASP.NET Core projesinin dışında ayrı bir projeye yerleştirme
Bilgisayarınızda yüklü çerçeve CLI'sini temel alarak istemci projesini oluşturma

Not

Bu makalede, Vite CLI kullanan Visual Studio 2022 sürüm 17.8'de güncelleştirilmiş şablonun kullanıldığı proje oluşturma işlemi açıklanmaktadır.

Önkoşullar

ASP.NET ve web geliştirme iş yükü yüklü visual studio 2022 sürüm 17.8 veya üzeri. Ücretsiz yüklemek için Visual Studio indirmeleri sayfasına gidin. İş yükünü yüklemeniz gerekiyorsa ve zaten Visual Studio'nuz varsa Araçlar>Araçları ve Özellikleri Al...'e gidin ve bu da Visual Studio Yükleyicisi açar. ASP.NET ve web geliştirme iş yükünü ve ardından Değiştir'i seçin.
npm (https://www.npmjs.com/), Node.js
npx (https://www.npmjs.com/package/npx)

Ön uç uygulamasını oluşturma

Başlangıç penceresinde Yeni proje oluştur'u seçin.
Üstteki arama çubuğunda React'i arayın ve react ve ASP.NET Core (Önizleme) öğesini seçin. Bu şablon bir JavaScript şablonudur.
Projeye ReactWithASP adını verin ve Oluştur'u seçin.

Çözüm Gezgini aşağıdaki proje bilgilerini gösterir:

Tek başına React şablonuyla karşılaştırıldığında, ASP.NET Core ile tümleştirme için bazı yeni ve değiştirilmiş dosyalar görürsünüz:
- vite.config.js
- App.js (değiştirildi)
- App.test.js (değiştirildi)
Chrome veya Microsoft Edge gibi Hata ayıklama araç çubuğundan yüklü bir tarayıcı seçin.

İstediğiniz tarayıcı henüz yüklü değilse, önce tarayıcıyı yükleyin ve ardından seçin.

Proje özelliklerini ayarlama

Çözüm Gezgini ReactWithASP.Server projesine sağ tıklayın ve Özellikler'i seçin.
Özellikler sayfasında Hata Ayıkla sekmesini açın ve Hata ayıklama başlatma profilleri kullanıcı arabirimini aç seçeneğini belirleyin. ASP.NET Core projesinden (veya varsa https) sonra adlandırılan profil için Tarayıcıyı Başlat seçeneğinin işaretini kaldırın.

Bu değer, kaynak hava durumu verileriyle web sayfasının açılmasını engeller.

Not

Visual Studio'da launch.json, Başlat düğmesiyle ilişkilendirilmiş başlangıç ayarlarını Hata Ayıklama araç çubuğunda depolar. Şu anda launch.json .vscode klasörünün altında bulunmalıdır.

Projeyi başlatma

Uygulamayı başlatmak için F5 tuşuna basın veya pencerenin üst kısmındaki Başlangıç düğmesini seçin. İki komut istemi görüntülenir:

çalışan ASP.NET Core API projesi
Gibi bir ileti gösteren Vite CLI VITE v4.4.9 ready in 780 ms

Not

İletiler için konsol çıkışını denetleyin. Örneğin, Node.js güncelleştirilecek bir ileti olabilir.

React uygulaması görünür ve API aracılığıyla doldurulur. Uygulamayı görmüyorsanız bkz . Sorun giderme.

Projeyi yayımlama

Çözüm Gezgini ReactWithASP.Server projesine sağ tıklayın ve Proje Başvurusu Ekle'yi>seçin.

reactwithasp.client projesinin seçili olduğundan emin olun.
Tamam'ı seçin.
ASP.NET Core projesine yeniden sağ tıklayın ve Proje Dosyasını Düzenle'yi seçin.

Bu işlem , projenin .csproj dosyasını açar.
.csproj dosyasında, proje başvurusunun değerine ayarlanmış falsebir <ReferenceOutputAssembly> öğe içerdiğinden emin olun.

Bu başvuru aşağıdaki gibi görünmelidir.
```
 <ProjectReference Include="..\reactwithasp.client\reactwithasp.client.esproj">
   <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
 </ProjectReference>
```
ASP.NET Core projesine sağ tıklayın ve bu seçenek varsa Projeyi Yeniden Yükle'yi seçin.

Program.cs aşağıdaki kodun mevcut olduğundan emin olun.

app.UseDefaultFiles();
app.UseStaticFiles();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
   app.UseSwagger();
   app.UseSwaggerUI();
}

Yayımlamak için ASP.NET Core projesine sağ tıklayın, Yayımla'yı seçin ve azure gibi istediğiniz yayımlama senaryosuyla eşleşecek seçenekleri belirtin( örneğin, bir klasörde yayımla vb.).

Yayımlama işlemi yalnızca bir ASP.NET Core projesi için olduğundan daha fazla zaman alır çünkü npm run build yayımlama sırasında komut çağrılır. BuildCommand varsayılan olarak çalışırnpm run build.

Sorun giderme

Ara sunucu hatası

Aşağıdaki hatayı görebilirsiniz:

[HPM] Error occurred while trying to proxy request /weatherforecast from localhost:4200 to https://localhost:7183 (ECONNREFUSED) (https://nodejs.org/api/errors.html#errors_common_system_errors)

Bu sorunu görürseniz, büyük olasılıkla ön uç arka uçtan önce başladı. Arka uç komut isteminin çalışır durumda olduğunu gördüğünüzde, tarayıcıda React Uygulamasını yenilemeniz yeter.

Bağlantı noktalarını doğrulama

Hava durumu verileri doğru yüklenmiyorsa bağlantı noktalarınızın doğru olduğunu da doğrulamanız gerekebilir.

Bağlantı noktası numaralarının eşleştiğinden emin olun. ASP.NET Core ReactWithASP.Server projesinde (Özellikler klasöründe) launch Ayarlar.json dosyasına gidin. Özelliğinden applicationUrl bağlantı noktası numarasını alın.

Birden çok applicationUrl özellik varsa uç nokta kullanan bir https özellik arayın. gibi https://localhost:7183görünür.
React projesi için vite.config.js dosyasını açın. target özelliğini başlatma Ayarlar.json özelliğiyle applicationUrleşleşecek şekilde güncelleştirin. Güncelleştirilmiş değer aşağıdakine benzer:
```
target: 'https://localhost:7183/',
```

Gizlilik hatası

Aşağıdaki sertifika hatasını görebilirsiniz:

Your connection isn't private

React sertifikalarını %appdata%\local\asp.net\https veya %appdata%\roaming\asp.net\https konumundan silmeyi deneyin ve sonra yeniden deneyin.

Sonraki adımlar

ASP.NET Core'daki SPA uygulamaları hakkında daha fazla bilgi için Tek Sayfalı Uygulamalar Geliştirme altındaki React bölümüne bakın. Bağlantılı makale, aspnetcore-https.js gibi proje dosyaları için ek bağlam sağlar, ancak uygulamanın ayrıntıları şablon farklılıklarına göre farklıdır. Örneğin, ClientApp klasörü yerine React dosyaları ayrı bir projede yer alır.

İstemci projesine özgü MSBuild bilgileri için bkz . JSPS için MSBuild özellikleri.