Öğretici: Visual Studio'da C# ve ASP.NET Core kullanmaya başlama

1. Başlangıç penceresinde Yeni proje oluştur'u seçin.

   

2. Yeni proje oluştur penceresinde Dil listesinden C# öğesini seçin. Ardından platform listesinden Windows'ı ve proje türleri listesinden Web'i seçin.

   Dil, platform ve proje türü filtrelerini uyguladıktan sonra ASP.NET Core Web App şablonunu ve ardından İleri'yi seçin.

   

   Not

   ASP.NET Core Web App şablonunu görmüyorsanız, yeni proje oluştur penceresinden yükleyebilirsiniz.

   Şablon listesinin en altındaki Aradığınızı bulamıyor musunuz? iletisinde Daha fazla araç ve özellik yükle bağlantısını seçin.

   

   Visual Studio Yükleyicisi ASP.NET ve web geliştirme'yi seçin.

   

   Visual Studio Yükleyicisi Değiştir'i seçin. Çalışmanızı kaydetmeniz istenebilir. İş yükünü yüklemek için Devam'ı seçin.

   Bu "Proje oluşturma" yordamında 2. adıma dönün.

3. Yeni projenizi yapılandırın penceresinde Proje adı alanına MyCoreAppgirin. Ardından İleri'yi seçin.

   

4. Ek bilgiler penceresinde Hedef Çerçeve alanında .NET Core 3.1'in göründüğünü doğrulayın.

   Bu pencereden Docker desteğini etkinleştirebilir ve kimlik doğrulama desteği ekleyebilirsiniz. Kimlik Doğrulama Türü açılır menüsünde aşağıdaki dört seçenek bulunur:

   • Hiçbiri: Kimlik doğrulaması yok.
   • Tek tek hesaplar: Bu kimlik doğrulamaları yerel veya Azure tabanlı bir veritabanında depolanır.
   • Microsoft kimlik platformu: Bu seçenek kimlik doğrulaması için Microsoft Entra Id veya Microsoft 365 kullanır.
   • Windows: İntranet uygulamaları için uygundur.

   Docker'ı Etkinleştir kutusunu işaretsiz bırakın ve Kimlik Doğrulama Türü için Yok'a tıklayın.

   

5. Oluştur'u belirleyin.

Visual Studio yeni projenizi açar.

1. Başlangıç penceresinde Yeni proje oluştur'u seçin.

   

2. Yeni proje oluştur penceresinde Dil listesinden C# öğesini seçin. Ardından platform listesinden Windows'ı ve proje türleri listesinden Web'i seçin.

   Dil, platform ve proje türü filtrelerini uyguladıktan sonra ASP.NET Core Web App şablonunu ve ardından İleri'yi seçin.

   

   Not

   ASP.NET Core Web App şablonunu görmüyorsanız, yeni proje oluştur penceresinden yükleyebilirsiniz.

   Şablon listesinin en altındaki Aradığınızı bulamıyor musunuz? iletisinde Daha fazla araç ve özellik yükle bağlantısını seçin.

   

   Visual Studio Yükleyicisi ASP.NET ve web geliştirme iş yükünü seçin.

   

   Visual Studio Yükleyicisi Değiştir'i seçin. Çalışmanızı kaydetmeniz istenebilir. İş yükünü yüklemek için Devam'ı seçin.

   Bu "Proje oluşturma" yordamında 2. adıma dönün.

3. Yeni projenizi yapılandırın penceresinde Proje adı alanına MyCoreAppgirin. Ardından İleri'yi seçin.

   

4. Ek bilgiler penceresinde Hedef Çerçeve alanında .NET 8.0'ın göründüğünü doğrulayın.

   Bu pencereden Docker desteğini etkinleştirebilir ve kimlik doğrulama desteği ekleyebilirsiniz. Kimlik Doğrulama Türü açılır menüsünde aşağıdaki dört seçenek bulunur:

   • Hiçbiri: Kimlik doğrulaması yok.
   • Tek tek hesaplar: Bu kimlik doğrulamaları yerel veya Azure tabanlı bir veritabanında depolanır.
   • Microsoft kimlik platformu: Bu seçenek kimlik doğrulaması için Microsoft Entra Id veya Microsoft 365 kullanır.
   • Windows: İntranet uygulamaları için uygundur.

   Docker'ı Etkinleştir kutusunu işaretsiz bırakın ve Kimlik Doğrulama Türü için Yok'a tıklayın.

   

5. Oluştur'u belirleyin.

Visual Studio yeni projenizi açar.

Çözümünüzde gezinin

1. Proje şablonu, MyCoreApp adlı tek bir ASP.NET Core projesiyle bir çözüm oluşturur. İçeriğini görüntülemek için Çözüm Gezgini sekmesini seçin.

   

2. Sayfalar klasörünü genişletin.

   

3. Index.cshtml dosyasını seçin ve dosyayı kod düzenleyicisinde görüntüleyin.

   

4. Her .cshtml dosyasının ilişkili bir kod dosyası vardır. Kod dosyasını düzenleyicide açmak için Çözüm Gezgini'da Index.cshtml düğümünü genişletin ve Index.cshtml.cs dosyasını seçin.

   

5. Kod düzenleyicisinde Index.cshtml.cs dosyasını görüntüleyin.

   

6. Proje, web sitenizin kökü olan bir wwwroot klasörü içerir. İçeriğini görüntülemek için klasörü genişletin.

   

   CSS, görüntüler ve JavaScript kitaplıkları gibi statik site içeriğini doğrudan istediğiniz yollara yerleştirebilirsiniz.

   Proje, çalışma zamanında web uygulamasını yöneten yapılandırma dosyalarını da içerir. Varsayılan uygulama yapılandırması appsettings.json dosyasında depolanır. Ancak, uygulama ayarları kullanarak bu ayarları geçersiz kılabilirsiniz. Development.json.

7. appsettings.json dosyasını genişleterek appsettings'i görüntüleyin. Development.json dosyası.

   

Çalıştırma, hata ayıklama ve değişiklik yapma

1. Uygulamayı hata ayıklama modunda derlemek ve çalıştırmak için araç çubuğunda IIS Express düğmesini seçin. Alternatif olarak, F5 tuşuna basın veya menü çubuğundan Hata AyıklamaYı>Başlat Hata Ayıklama'yagidin.

   

   Not

   'IIS Express' web sunucusuna bağlanılamıyor hata iletisi alırsanız, Visual Studio'yu kapatın ve ardından programı yönetici olarak yeniden başlatın. Bu görevi, Başlat Menüsünden Visual Studio simgesine sağ tıklayıp bağlam menüsünden Yönetici olarak çalıştır seçeneğini belirleyerek yapabilirsiniz.

   Iis SSL Express sertifikasını kabul etmek isteyip istemediğinizi soran bir ileti de alabilirsiniz. Kodu bir web tarayıcısında görüntülemek için Evet'i seçin ve ardından bir izleme güvenlik uyarısı iletisi alırsanız Evet'i seçin.

2. Visual Studio bir tarayıcı penceresi başlatır. Ardından menü çubuğunda Giriş ve Gizlilik sayfalarını görmeniz gerekir.

3. Menü çubuğundan Gizlilik'i seçin. Tarayıcıdaki Gizlilik sayfası, Privacy.cshtml dosyasında ayarlanan metni işler.

   

4. Visual Studio'ya dönün ve hata ayıklamayı durdurmak için Shift+F5 tuşlarına basın. Bu eylem, tarayıcı penceresinde projeyi kapatır.

5. Visual Studio'da düzenleme için Privacy.cshtml dosyasını açın. Ardından, tümceyi silin, Sitenizin gizlilik ilkesini ayrıntılı olarak görüntülemek için bu sayfayı kullanın ve ["TimeStamp"] itibarıyla @ViewDataBu sayfa yapım aşamasındadır.

   

6. Şimdi kod değişikliği yapalım. Privacy.cshtml.cs dosyasını seçin. Ardından, aşağıdaki kısayolu using kullanarak dosyanın üst kısmındaki yönergeleri temizleyin:

   Fareyle geçiş yapın veya gri renkte using bir yönerge seçin. Giriş işaretinin altında veya sol kenar boşluğunda hızlı eylemler ampulü görünür. Ampulü seçin ve ardından Gereksiz kullanımı kaldır'ı seçin.

   

   Şimdi değişiklikleri önizleme'yi seçerek değişiklikleri görün.

   

   Uygula'yı seçin. Visual Studio gereksiz using yönergeleri dosyadan siler.

7. Ardından, yönteminde OnGet() gövdeyi aşağıdaki kodla değiştirin:

   public void OnGet()
   {
      string dateTime = DateTime.Now.ToShortDateString();
      ViewData["TimeStamp"] = dateTime;
   }
   

8. DateTime altında dalgalı bir alt çizgi göründüğüne dikkat edin. Bu tür kapsamda olmadığından dalgalı alt çizgi görüntülenir.

   

   Aynı hataların burada listelendiğini görmek için Hata Listesi araç çubuğunu açın. Hata Listesi araç çubuğunu görmüyorsanız üst menü çubuğundan Hata Listesini Görüntüle'ye> gidin.

   

9. Şimdi bu hatayı düzeltelim. Kod düzenleyicisinde, imlecinizi hatayı içeren satırın üzerine getirin ve sol kenar boşluğundaki Hızlı Eylemler ampulü seçin. Ardından açılan menüden Sistem'i kullanarak öğesini seçin ; bu yönergeyi dosyanızın en üstüne ekleyin ve hataları çözün.

   

10. Projenizi web tarayıcısında açmak için F5 tuşuna basın.

11. Değişikliklerinizi görüntülemek için web sitesinin üst kısmında Gizlilik'i seçin.

    

12. Hata ayıklamayı durdurmak için web tarayıcısını kapatın, Shift F5 tuşlarına+basın.

Giriş sayfanızı değiştirme

1. Çözüm Gezgini Sayfalar klasörünü genişletin ve ardından Index.cshtml öğesini seçin.

   

   Index.cshtml dosyası, web tarayıcısında çalışan web uygulamasındaki Giriş sayfanıza karşılık gelir.

   

   Kod düzenleyicisinde, Giriş sayfasında görüntülenen metin için HTML kodu görürsünüz.

   

2. Hoş Geldiniz metnini Merhaba Dünya!

   

3. IIS Express'i seçin veya uygulamayı çalıştırmak ve bir web tarayıcısında açmak için Ctrl+F5 tuşlarına basın.

   

4. Web tarayıcısında, giriş sayfasında yeni değişikliklerinizi görürsünüz.

   

5. Web tarayıcısını kapatın, hata ayıklamayı durdurmak için Shift+F5 tuşuna basın ve projenizi kaydedin. Artık Visual Studio'yu kapatabilirsiniz.

Çözümünüzde gezinin

1. Proje şablonu, MyCoreApp adlı tek bir ASP.NET Core projesiyle bir çözüm oluşturur. İçeriğini görüntülemek için Çözüm Gezgini sekmesini seçin.

   

2. Sayfalar klasörünü genişletin.

   

3. Index.cshtml dosyasını seçin ve kod düzenleyicisinde görüntüleyin.

   

4. Her .cshtml dosyasının ilişkili bir kod dosyası vardır. Kod dosyasını düzenleyicide açmak için Çözüm Gezgini'da Index.cshtml düğümünü genişletin ve Index.cshtml.cs dosyasını seçin.

   

5. Kod düzenleyicisinde Index.cshtml.cs dosyasını görüntüleyin.

   

6. Proje, web sitenizin kökü olan bir wwwroot klasörü içerir. İçeriğini görüntülemek için klasörü genişletin.

   

   CSS, görüntüler ve JavaScript kitaplıkları gibi statik site içeriğini doğrudan istediğiniz yollara yerleştirebilirsiniz.

7. Proje, çalışma zamanında web uygulamasını yöneten yapılandırma dosyalarını da içerir. Varsayılan uygulama yapılandırması appsettings.json dosyasında depolanır. Ancak, uygulama ayarları kullanarak bu ayarları geçersiz kılabilirsiniz. Development.json. appsettings.json dosyasını genişleterek appsettings'i görüntüleyin. Development.json dosyası.

   

Çalıştırma, hata ayıklama ve değişiklik yapma

1. Uygulamayı hata ayıklama modunda derlemek ve çalıştırmak için araç çubuğunda IIS Express düğmesini seçin. Alternatif olarak, F5 tuşuna basın veya menü çubuğundan Hata AyıklamaYı>Başlat Hata Ayıklama'yagidin.

   

   Not

   'IIS Express' web sunucusuna bağlanılamıyor hata iletisi alırsanız, Visual Studio'yu kapatın ve ardından programı yönetici olarak yeniden başlatın. Bu görevi, Başlat Menüsünden Visual Studio simgesine sağ tıklayıp bağlam menüsünden Yönetici olarak çalıştır seçeneğini belirleyerek yapabilirsiniz.

   Iis SSL Express sertifikasını kabul etmek isteyip istemediğinizi soran bir ileti de alabilirsiniz. Kodu bir web tarayıcısında görüntülemek için Evet'i seçin ve ardından bir izleme güvenlik uyarısı iletisi alırsanız Evet'i seçin.

2. Visual Studio bir tarayıcı penceresi başlatır. Ardından menü çubuğunda Giriş ve Gizlilik sayfalarını görmeniz gerekir.

3. Menü çubuğundan Gizlilik'i seçin. Tarayıcıdaki Gizlilik sayfası, Privacy.cshtml dosyasında ayarlanan metni işler.

   

4. Visual Studio'ya dönün ve hata ayıklamayı durdurmak için Shift+F5 tuşlarına basın. Bu eylem, tarayıcı penceresinde projeyi kapatır.

5. Visual Studio'da düzenleme için Privacy.cshtml dosyasını açın. Ardından, tümceyi silin, Sitenizin gizlilik ilkesini ayrıntılı olarak görüntülemek için bu sayfayı kullanın ve ["TimeStamp"] itibarıyla @ViewDataBu sayfa yapım aşamasındadır.

   

6. Şimdi kod değişikliği yapalım. Privacy.cshtml.cs dosyasını seçin. Ardından, aşağıdaki kısayolu using seçerek dosyanın en üstündeki yönergeleri temizleyin:

   Fareyle geçiş yapın veya gri renkte using bir yönerge seçin. Giriş işaretinin altında veya sol kenar boşluğunda hızlı eylemler ampulü görünür. Ampulü seçin ve ardından Gereksiz kullanımı kaldır'ın yanındaki genişletme okunu seçin.

   

   Şimdi değişiklikleri önizleme'yi seçerek değişiklikleri görün.

   

   Uygula'yı seçin. Visual Studio gereksiz using yönergeleri dosyadan siler.

7. Ardından DateTime.ToString yöntemini kullanarak kültürünüz veya bölgeniz için biçimlendirilmiş geçerli tarih için bir dize oluşturun.

   • yöntemi için ilk bağımsız değişken, tarihin nasıl görüntüleneceğini belirtir. Bu örnekte, kısa tarih biçimini gösteren biçim belirticisi (d) kullanılır.
   • İkinci bağımsız değişken, tarih için kültürü veya bölgeyi belirten CultureInfo nesnesidir. İkinci bağımsız değişken, tarihteki herhangi bir sözcüğün dilini ve kullanılan ayırıcıların türünü belirler.

   yönteminin gövdesini OnGet() aşağıdaki kodla değiştirin:

   public void OnGet()
   {
      string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US"));
      ViewData["TimeStamp"] = dateTime;
   }
   

8. Aşağıdaki using yönergenin dosyanın en üstüne otomatik olarak eklendiğine dikkat edin:

   using System.Globalization;
   

   System.GlobalizationCultureInfo sınıfını içerir.

9. Projenizi web tarayıcısında açmak için F5 tuşuna basın.

10. Değişikliklerinizi görüntülemek için web sitesinin üst kısmında Gizlilik'i seçin.

    

11. Hata ayıklamayı durdurmak için web tarayıcısını kapatın, Shift F5 tuşlarına+basın.

Giriş sayfanızı değiştirme

1. Çözüm Gezgini Sayfalar klasörünü genişletin ve ardından Index.cshtml öğesini seçin.

   

   Index.cshtml dosyası, web tarayıcısında çalışan web uygulamasındaki Giriş sayfanıza karşılık gelir.

   

   Kod düzenleyicisinde, Giriş sayfasında görüntülenen metin için HTML kodu görürsünüz.

   

2. Hoş Geldiniz metnini Merhaba Dünya!

   

3. IIS Express'i seçin veya uygulamayı çalıştırmak ve bir web tarayıcısında açmak için Ctrl+F5 tuşlarına basın.

   

4. Web tarayıcısında, giriş sayfasında yeni değişikliklerinizi görürsünüz.

   

5. Web tarayıcısını kapatın, hata ayıklamayı durdurmak için Shift+F5 tuşuna basın ve projenizi kaydedin. Artık Visual Studio'yu kapatabilirsiniz.