.NET Proje Tasarımcısı

Projenin .NET ayarlarını ve özelliklerini belirtmek için Proje Tasarımcısı'nı kullanın. .NET Framework özellikleri veya tüm proje özelliklerine genel bakış için bkz. Proje ve çözüm özelliklerini yönetme.

Proje Tasarımcısı'na erişmek için, Çözüm Gezginibir proje düğümü (Çözüm düğümü değil) seçin. Ardından menü çubuğunda project >seçin. Proje Tasarımcısı görüntülenir.

Note

Bu makaledeki yönergeler, Visual Studio'da kullanılabilen etkileşimli geliştirme deneyiminin (IDE) en son sürümünü gösterir. Bilgisayarınız bazı kullanıcı arabirimi öğeleri için farklı adlar veya konumlar gösterebilir. Visual Studio'nun farklı bir sürümünü veya farklı ortam ayarlarını kullanıyor olabilirsiniz. Daha fazla bilgi için bkz. IDEkişiselleştirme.

Uygulama, Genel ayarlar

Aşağıdaki seçenekler, uygulama için genel ayarları yapılandırmanızı sağlar.

Çıkış türü

Derlemek için uygulamanın türünü belirtir. Değerler, proje türüne bağlı olarak farklıdır. Örneğin, Konsol Uygulaması projesi için, çıkış türü olarak Windows Uygulaması , Konsol Uygulamasıveya Sınıf Kitaplığıbelirtebilirsiniz.

Çıktı türü özelliği hakkında daha fazla bilgi için bkz. /target (C# Derleyici Seçenekleri).

Bu özelliğe program aracılığıyla erişme hakkında bilgi için bkz. OutputType.

Hedef Çerçeve

Uygulamanın hedeflediğini .NET sürümünü belirtir. Bu seçenek, bilgisayarınızda hangi .NET sürümlerinin yüklü olduğu bağlı olarak farklı değerlere sahip olabilir.

.NET'i hedefleyen bir proje için, kullanılabilir sürümler aşağıdaki gibi görünebilir:

Note

ClickOnce uygulamaları için, Önkoşullar İletişim Kutusu listelenen önkoşul paketleri, iletişim kutusunu ilk kez açtığınızda otomatik olarak ayarlanır. Projenin hedef çerçevesini daha sonra değiştirirseniz, yeni hedef çerçeveyle eşleşmesi için önkoşulları el ile seçmeniz gerekir.

Daha fazla bilgi için bkz. Framework hedeflemeye genel bakış.

Hedef işletim sistemi

Projenin hedefleeceği işletim sistemini belirtir. Hedef çerçeveyle birlikte bu, .NET işletim sistemine özgü bir TFM oluşturur.

Başlangıç nesnesi

Uygulama yüklendiğinde çağrılacak giriş noktasını tanımlar. Genellikle bu, uygulamanızda ana forma veya uygulama başlatıldığında çalışması gereken Main yordamına ayarlanır. Sınıf kitaplıklarının giriş noktası olmadığından, bu özelliğin tek seçeneği (Ayarlanmadı) seçeneğidir.

Varsayılan olarak, wpf uygulama projesinde bu seçenek (Ayarlanmadı) olarak ayarlanır. Diğer seçenek ise [projectname].App şeklindedir. WPF projesinde, uygulama başlatıldığında kullanıcı arabirimi kaynağını yüklemek için başlangıç URI'sini ayarlamanız gerekir. Bunu yapmak için projenizde Application.xaml dosyasını açın ve StartupUri özelliğini projenizdeki .xaml dosyası olarak ayarlayın( Window1.xamlgibi). Kabul edilebilir kök öğelerin listesi için bkz. StartupUri. Ayrıca, projedeki bir sınıfta bir public static void Main() yöntemi tanımlamanız gerekir. Bu sınıf, Başlangıç nesnesi listesinde ProjectName.ClassName olarak görünür. Ardından başlangıç nesnesi olarak sınıfını seçebilirsiniz.

Daha fazla bilgi için /main (C# Derleyici Seçenekleri) bakın. Bu özelliğe program aracılığıyla erişmek için bkz. StartupObject.

Derleme adı

Derleme bildirimini barındıracak çıkış dosyasının adını belirtir. Bu özelliğin değiştirilmesi, Çıktı Adı özelliğini de değiştirir.

Bu değişikliği komut satırından /out (C# Derleyici Seçenekleri)kullanarak da yapabilirsiniz.

Bu özelliğe program aracılığıyla erişmek için bkz. AssemblyName.

Varsayılan ad alanı

Projeye eklenen dosyalar için temel ad alanını belirtir.

Kodunuzda ad alanı oluşturma hakkında daha fazla bilgi için bkz. ad alanı.

Bu özelliğe program aracılığıyla erişmek için bkz. RootNamespace.

Uygulama, Win32 Kaynakları ayarları

Icon

Program simgesi olarak kullanmak istediğiniz .ico dosyasını ayarlar. Var olan bir grafiğe göz atmak için Gözat'e tıklayın veya istediğiniz dosyanın adını yazın. Daha fazla bilgi için bkz. /win32icon (C# Derleyici Seçenekleri).

Bu özelliğe program aracılığıyla erişmek için bkz. ApplicationIcon.

Simge oluşturma hakkında bilgi için bkz. simgeler için görüntü düzenleyicisi.

Resources

Kaynaklar seçeneği, uygulamanız için kaynak ayarlarını yapılandırmanıza yardımcı olur. Varsayılan olarak, Simgesi ve Bildirim seçenekleri etkinleştirilir. Bu, kendi simgenizi seçmenize veya farklı bildirim oluşturma seçenekleri belirlemenize olanak tanır. Proje için bir kaynak dosyası sağlamadığınız sürece bu radyo düğmesini seçili bırakın.

Kaynak dosyasını seçerseniz proje için bir kaynak dosyası yapılandırın. Projeye bir Win32 kaynak dosyası eklemek için bir yol adı girin veya Gözat düğmesini kullanın. Daha fazla bilgi için bkz. .NET uygulamaları için kaynak dosyaları oluşturma .

Manifest

Uygulama, Kullanıcı Hesabı Denetimi (UAC) altında Windows üzerinde çalıştığında bir bildirim oluşturma seçeneği belirler. Bu seçenek aşağıdaki değerlere sahip olabilir:

• varsayılan ayarlarla Ekleme bildirimini. Visual Studio'nun Windows üzerinde çalıştığı tipik şekli destekler. Bu, uygulamanın yürütülebilir dosyasına güvenlik bilgileri eklemek ve requestedExecutionLevelAsInvokerolmasını belirtir. Bu varsayılan seçenektir.

• Bildirimolmadan uygulama oluşturma. Bu yöntem sanallaştırmaolarak bilinir. Önceki uygulamalarla uyumluluk için bu seçeneği kullanın.

• Özel bildirimkullanın. Bir yol girmenize veya proje için özel bir bildirime göz atmanıza olanak tanır.

Genel Kullanma ayarları

örtük genel kullanımı

genel kullanımlarını etkinleştirir veya devre dışı bırakır. Bu, ad alanında tanımlanan türleri tam ad alanını belirtmeden kullanmanıza olanak tanır.

Örtük Genel Kullanımı Yönetme

Projelerinizde kullanmak üzere genel kullanımları el ile ekleyin ve silin.

Derleme, Genel ayarlar

Koşullu derleme simgeleri

Koşullu derlemenin gerçekleştirildiği simgeleri belirtir. Simgeleri noktalı virgül (";") ile ayırın. Daha fazla bilgi için bkz. /define (C# Derleyici Seçenekleri).

Özel Simgelerde Hata Ayıklama

Hata ayıklama derlemeleri için koşullu derleme simgelerini belirtir. Varsayılan hata ayıklama simgeleri, noktalı virgülle ayrılmış bir dizede görüntülenir.

Özel Simgeler

Yayın derlemeleri için koşullu derleme simgelerini belirtir. Varsayılan yayın simgeleri, noktalı virgülle ayrılmış bir dizede görüntülenir.

Platform Hedefi

Çıkış dosyası tarafından hedeflenecek işlemciyi belirtir. 32 bit Intel uyumlu işlemciler için x86 seçin, 64 bit Intel uyumlu işlemciler için x64 seçin, ARM işlemciler için arm seçin veya herhangi bir işlemcinin kabul edilebilir olduğunu belirtmek için Herhangi bir CPU seçin. Tüm CPU, uygulamanın en geniş donanım aralığında çalışmasına izin verdiğinden projeler için varsayılan değerdir.

Daha fazla bilgi için bkz . /platform (C# Derleyici Seçenekleri).

Nullable

Proje genelinde C# null atanabilir bağlamını belirtir. Bu kullanıcı arabirimi seçeneği Visual Studio 16.5'te kullanıma sunulmuştur ve yalnızca C# 8.0 veya üzerini kullanan projeler için etkinleştirilmiştir.

Daha fazla bilgi için bkz. Null Atanabilir Bağlamlar.

Derleme bilgileri oluşturma

Paketle ilgili proje özelliklerinin derleme özniteliklerine dönüştürülüp dönüştürülmeyeceğini belirtir. Daha fazla bilgi için generateassemblyinfo özelliğine bakın.

Güvenli olmayan kod

Derlemek için güvenli olmayan anahtar sözcüğünü kullanan koda izin verir. Daha fazla bilgi için bkz. /unsafe (C# Derleyici Seçenekleri).

Kodun optimize edilmesi

Çıktı dosyanızı daha küçük, daha hızlı ve daha verimli hale getirmek için derleyici tarafından gerçekleştirilen iyileştirmeleri etkinleştirin veya devre dışı bırakın. Daha fazla bilgi için bkz. /optimize (C# Derleyici Seçenekleri).

Hata ayıklama simgeleri

Derleyici tarafından oluşturulan hata ayıklama bilgilerinin türünü belirtir. Bir uygulamanın hata ayıklama performansını yapılandırma hakkında bilgi için bkz. DebugType derleyici seçeneği. Bu ayar aşağıdaki seçeneklere sahiptir:

• none

  Hata ayıklama bilgisinin oluşturulmayacağını belirtir.

• full

  Çalışan programa hata ayıklayıcı eklemeyi etkinleştirir.

• pdbonly

  Program hata ayıklayıcıda başlatıldığında kaynak kodu hata ayıklamasına izin verir, ancak yalnızca çalışan program hata ayıklayıcıya eklendiğinde derleyiciyi görüntüler.

• portable

  Bir .PDB dosyası oluşturur; bu, platforma özgü olmayan, taşınabilir bir simge dosyasıdır ve diğer araçlara, özellikle hata ayıklayıcılar için, ana yürütülebilir dosyada ne olduğunu ve nasıl üretildiğini gösterir. Daha fazla bilgi için bkz. Taşınabilir PDB .

• embedded

  Taşınabilir simge bilgilerini derlemeye ekler. Harici bir .PDB dosyası üretilmez.

Daha fazla bilgi için bkz. /debug (C# Derleyici Seçenekleri).

Derleme, Hatalar ve uyarı ayarları

Derleme işlemi için hata ve uyarı seçeneklerini yapılandırmak için aşağıdaki ayarlar kullanılır.

Uyarı düzeyi

Derleyici uyarıları için görüntülenecek düzeyi belirtir. Daha fazla bilgi için bkz . /warn (C# Derleyici Seçenekleri).

Belirli uyarıları gizleme

Derleyicinin bir veya daha fazla özel uyarı oluşturma yeteneğini engeller. Birden çok uyarı numarasını virgül veya noktalı virgülle ayırın. Daha fazla bilgi için bkz . /nowarn (C# Derleyici Seçenekleri).

Uyarıları hata olarak ele

Derleme işlemi sırasında uyarıların hata olarak ele alıp almayacağını seçin. Daha fazla bilgi için bkz . /warnaserror (C# Derleyici Seçenekleri).

Belirli uyarıları hata olarak ele

Hangi uyarıların hata olarak işleneceğini belirtin. Birden çok uyarı numarasını virgül veya noktalı virgülle ayırın.

Tip

Kod analizi uyarılarının hata olarak değerlendirilmesini istemiyorsanız bkz. kod analizi SSS .

Derleme, Çıkış ayarları

Derleme işlemi için çıkış seçeneklerini yapılandırmak için aşağıdaki ayarlar kullanılır.

Temel çıkış yolu

Bu projenin yapılandırması için çıkış dosyalarının konumunu belirtir. Bu kutuya derleme çıkışının yolunu girin veya yol belirtmek için Gözat düğmesini seçin. Yol görelidir; mutlak bir yol girerseniz, göreli olarak kaydedilir. Varsayılan yol bin\Debug veya bin\Release\ şeklindedir.

Basitleştirilmiş derleme yapılandırmalarıyla, proje sistemi hata ayıklama veya sürüm oluşturma işleminin yapılıp yapılmayacağını belirler. Hata Ayıklama menüsünden (F5) Build komutu, belirttiğiniz Çıkış yolu bakılmaksızın derlemeyi hata ayıklama konumuna koyar. Ancak, Derleme menüsündeki Derleme komutu bunu belirttiğiniz konuma yerleştirir. Daha fazla bilgi için bkz. derleme yapılandırmalarını anlama .

Referans derlemesi

Projenin genel API'sini içeren bir başvuru derlemesi oluşturulup oluşturulmayacağını belirtir.

Belge dosyası

Belge açıklamalarının işlendiği dosyanın adını belirtir. Daha fazla bilgi için bkz . /doc (C# Derleyici Seçenekleri).

Derleme, Olay ayarları

Derleme olayı ayarları hakkında bilgi için bkz. Derleme olaylarını belirtme (C#).

Derleme, Yayımlama ayarları

Publishing

MSBuild yayımlama hedefinin çalışmasına izin verir. Daha fazla bilgi için bkz. MSBuild IsPublishable özelliği.

Kırpılmış yayımlama

Yayımlama işlemi sırasında kırpmanın etkinleştirilip etkinleştirilmediğini belirtir. Daha fazla bilgi için bkz. Kırpma ile ilgili özellikleri.

Yerel AOT yayımlama

Kendi içinde bulunan ve yerel koda derlenmiş önceden (AOT) olan bir uygulamanın üretilip üretmeyeceğini belirtir. Daha fazla bilgi için bkz: yerel AOT dağıtımı.

Derleme, Güçlü adlandırma ayarları

Derleme imzalama

Derlemeyi imzalamak ve kesin olarak adlandırılmış bir anahtar dosyası oluşturmak için bu onay kutusunu seçin. Proje Tasarımcısıkullanarak derlemeyi imzalama hakkında daha fazla bilgi için bkz. Nasıl yapılır: Derlemeyi İmzalama (Visual Studio). Daha fazla bilgi için bkz. Güçlü adlandırılmış derlemeler.

Bu seçenek, derlemeyi imzalamak için Windows Yazılım Geliştirme Seti (SDK) tarafından sağlanan Al.exe aracını kullanır. Al.exehakkında daha fazla bilgi için bkz. Nasıl yapılır: Derlemeyi Tanımlayıcı Adla İmzala.

Tanımlayıcı ad anahtarı dosyası listesi

Derlemeyi imzalamak için kullanılan yeni veya var olan bir kesin olarak adlandırılmış anahtar dosyası belirtmenizi sağlar. Mevcut bir anahtar dosyasını seçmek için Gözat...<>seçin.

Gecikme işareti yalnızca

İmzalama gecikmesini etkinleştirmek için bu onay kutusunu seçin. Daha fazla bilgi için bkz. Derlemeyigecikmeli imzalama.

Gecikmeli imzalı projenin çalışmayacağını ve hata ayıklanamayacağını unutmayın. Ancak geliştirme sırasında doğrulamayı atlamak için seçeneğiyle -Vr kullanabilirsiniz.

Note

Bir derlemeyi imzaladığınızda, özel anahtara her zaman erişiminiz olmayabilir. Örneğin, bir kuruluşun geliştiricilerin günlük olarak erişemeyen, yakından korunan bir anahtar çifti olabilir. Ortak anahtar kullanılabilir, ancak özel anahtara erişim birkaç kişi ile sınırlıdır. Böyle bir durumda, ortak anahtarı sağlamak için gecikmeli veya kısmi imzalama kullanabilir ve derleme devredilene kadar özel anahtarın eklenmesini erteleyebilirsiniz.

Derleme, Gelişmiş ayarlar

Aşağıdaki seçenekler gelişmiş derleme ayarlarını yapmanızı sağlar.

Dil versiyonu

/langversion (C# derleyici seçenekleri) bağlantıları, projenin hedef çerçevesine göre varsayılan dil sürümünün nasıl seçildiği hakkında bilgi sağlar.

Aritmetik taşma denetimi

denetlenen kapsamında olmayan bir tamsayı aritmetik deyiminin veya işaretsiz anahtar sözcükleri ve veri türü aralığının dışında bir değerle sonuçlanan bir çalışma zamanı özel durumu oluşturup oluşturmayacağını belirtir. Daha fazla bilgi için bkz. /checked (C# Derleyici Seçenekleri).

Deterministic

Aynı giriş kaynağından bayt için bayt eşdeğeri çıktı üretilip üretmeyeceğini belirtir. Daha fazla bilgi için bkz. kod oluşturmadenetleen C# Derleyici Seçenekleri.

İç derleyici hata raporlama

Derleyici hatalarının Microsoft'a bildirilip bildirmeyeceğini belirtir. istemi (varsayılan) olarak ayarlanırsa, bir iç derleyici hatası oluşursa size microsoft'a elektronik olarak hata raporu gönderme seçeneği sunan bir istem alırsınız. göndermeolarak ayarlanırsa, otomatik olarak bir hata raporu gönderilir. kuyruğa ayarlanırsa hata raporları kuyruğa alınır. hiçbiri olarak ayarlanırsa, hata yalnızca derleyicinin metin çıkışında bildirilir. Daha fazla bilgi için bkz. /errorreport (C# Derleyici Seçenekleri).

Dosya Hizalama

Çıkış dosyasındaki bölümlerin boyutunu belirtir. Geçerli değerler 512, 1024, 2048, 4096ve 8192. Bu değerler bayt cinsinden ölçülür. Her bölüm bu değerin katı olan bir sınıra hizalanır ve çıkış dosyasının boyutunu etkiler. Daha fazla bilgi için bkz. /filealign (C# Derleyici Seçenekleri).

Paket, Genel ayarlar

Bu bölümdeki özellikler, genellikle bir NuGet .nuspec dosyasındaki özelliklere karşılık gelen paketleri yapılandırmak için kullanılır. Daha fazla bilgi için bkz. .nuspec dosyası.

Paket, Lisans ayarları

Paket Lisansı

Paketinize bir lisans ifadesi veya lisans dosyası eklenip eklenmeyeceğini belirtir. Daha fazla bilgi için lisans öğesine bakın.

Paket, Simge ayarları

Sembol paketi oluşturma

Hata ayıklama için bir sembol paketi oluşturulup oluşturulmayacağını belirtir. Daha fazla bilgi için bkz. Sembol paketleri oluşturma (.snupkg).

Kod Analizi, Tüm çözümleyici ayarları

derleme üzerinde Çalıştırma

Projeyi oluştururken kaynak kod çözümlemesinin çalıştırılıp çalıştırılmayacağını belirtir. Daha fazla bilgi için bkz. .NET için kaynak kodu çözümlemesini devre dışı bırakma.

Canlı analizde çalıştır

Projeyi oluştururken canlı kaynak kod analizi çalıştırılıp çalıştırılmayacağını belirtir. Daha fazla bilgi için bkz. .NET için kaynak kodu çözümlemesini devre dışı bırakma.

Kod Analizi, .NET çözümleyici ayarları

Derlemede kod stilini zorunlu kılma

Projeyi oluştururken .NET kod stili ihlallerinin bildirilip bildirmeyeceğini belirtir. Daha fazla bilgi için bkz. derleme kod stillerini zorlama.

.NET çözümleyicilerini etkinleştirme

.NET derleyici platformu (Roslyn) çözümleyicilerini etkinleştirir veya devre dışı bırakır. Daha fazla bilgi için bkz. birinci taraf .NET çözümleyicilerini etkinleştirme veya yükleme.

Analiz düzeyi

Projede çalıştırılacak çözümleyici kümesini belirtir. Daha fazla bilgi için kod analizine genel bakış makalesinin en son güncelleştirmeler bölümüne bakın.

Hata ayıklama, Genel ayarlar

Hata ayıklama başlatma profilleri kullanıcı arabirimini açmak için bağlantıyı seçin. Bu kullanıcı arabirimi, hata ayıklarken kullanılacak farklı profiller eklemenize ve yapılandırmanıza olanak tanır. Her profil adı, Hata Ayıklamayı Başlat listesinde bir başlangıç seçeneği olarak görünür.

ASP.NET Core projelerinde, başlatma profilleri kullanıcı arabirimindeki ayarlar projenin launchSettings.json dosyasındaki ayarlara karşılık gelir. Bu dosyanın ASP.NET geliştirmede nasıl kullanıldığı hakkında ayrıntılı bilgi için bkz. geliştirme ve launchSettings.json.

Kaynaklar, Genel ayarlar

RESX derleme kaynakları dosyasını açmak için bağlantıyı seçin. Daha fazla bilgi için bkz. Ayarlar sayfası, Proje Tasarımcısı.

Ayrıca bakınız

Yenilenmiş Proje Özellikleri Kullanıcı Arabirimi