.NET Kodu Katman Diyagramlarına Karşı Nasıl Doğrulanır

Bu konu şunlar için geçerlidir:

Visual Studio Ultimate	Visual Studio Premium	Visual Studio Professional	Visual Studio Express

Katman diyagramına karşı kodu doğrulama geliştikçe koddaki mimari kısıtlamaları zorlamanıza yardımcı olur. Bu görevi gerçekleştirdiğiniz zaman koddaki bağımlılıklar diyagramdaki bağımlılıklar ile karşılaştırılır. Katman doğrulama aşağıdaki görevler ile de size yardımcı olabilir:

• Varolan kod ile onun hedeflenen tasarımı arasındaki farklara bakın.

• Amaçlandığı şekilde düzenlenmemiş veya istenmeyen bağımlılıkları olan kodu bulun.

• Önerilen değişiklikler tarafından etkilenebilecek bağımlılıkları bulun.

  Örneğin, olası mimari değişiklikleri göstermek için katman diyagramını düzenleyebilir ve sonra etkilenen bağımlılıkları görmek için kodu doğrulayabilirsiniz. Daha fazla bilgi için, bkz:Nasıl yapılır: Yapılardan Katman Diyagramları Oluşturma ve Katman Diyagramları: Yönergeler.

• Yeniden düzenleyin veya kodu farklı bir tasarıma geçirin.

  Kodu farklı bir mimariye taşıdığınız zaman hala iş gerektiren kodu veya bağımlılıkları bulun.

Kodu doğrulayabilmeniz için, Visual Studio çözümünüz bir katmak diyagramına sahip en az bir modelleme projesi içermelidir. Katman diyagramı sistemin mimarisini açıklar ve ad alanları, projeler ve diğer yapıları mantıksal, soyut gruplar ya da katmanlar halinde düzenler. Bu katmanlar sistemin ana bileşenlerini veya yapıların gerçekleştirdiği görevleri açıklar. Bu katmanları tanımlamalı, yapıları onlara bağlamalı ve bu yapılar arasında amaçlanan bağımlılıkları açıklamalısınız.

Katman diyagramlarının nasıl oluşturulduğu hakkında daha fazla bilgi için aşağıdaki konulara bakınız:

• Nasıl yapılır: Yapılardan Katman Diyagramları Oluşturma

• Katman Diyagramları: Yönergeler

• Katman Diyagramları: Başvuru

C ya da C++ kodu doğrulamak için Temp Topic'u karşıdan yükleyin ve kurun.

Daha fazla bilgi için bkz. How to: Validate C and C++ Code Against Layer Diagrams.

Bu Konuda

• Doğrulama için derlemeleri ve projeleri elle ekleyin.

• Kodu el ile herhangi bir zamanda doğrulama.

• Kodu yerel yapı sırasında otomatik olarak doğrulama.

• Kodu Team Foundation Yapısı sırasında otomatik olarak doğrulama.

• Katman doğrulama ile ilgili sorunlarda sorun giderme

Doğrulama İçin Derlemeleri ve Projeleri Elle Ekleyin

Bir modelleme projesindeki Katman Başvuruları klasörü doğrulama sırasında çözümlenen derleme ve projelere başvuru içerir. Öğeleri katman diyagramına sürüklediğinizde, onlara karşılık gelen derlemelere veya projelere başvurular otomatik olarak bu klasöre eklenir. Ayrıca, derlemeleri ve projeleri katman diyagramına sürüklemeden doğrulama için el ile ekleyebilirsiniz.

Doğrulama için derlemeleri ve projeleri elle eklemek için

1. Çözüm Gezgini'nde, modelleme projesine veya Katman Başvuruları dosyasına sağ tıklayın ve sonra da Başvuru Ekle'ye tıklayın.

2. Başvuru Ekle iletişim kutusunda derlemeleri veya projeleri seçin ve sonra Tamam'a tıklayın.

Kodu El ile Herhangi Bir Zamanda Doğrulama

Kodu açık katman diyagramından doğrulamak için

1. Diyagram yüzeyini sağ tıklayın ve sonra Mimariyi Doğrula'ya tıklayın.

   Not

   Varsayılan olarak, doğrulama işleminde diyagramın olması için katman diyagramı (.layerdiagram) dosyasındaki Yapı Eylemi özelliği Doğrula'ya ayarlanır.

   Hata Listesi penceresi oluşan hataları bildirir. Doğrulama hataları hakkında daha fazla bilgi için bkz. Katman Doğrulama Hatalarını Anlama.

2. Her hatanın kaynağını görüntülemek için Hata Listesi penceresindeki hataya çift tıklayın.

   Not

   Visual Studio hatanın kaynağı yerine bağımlılık grafiği gösterebilir. Bu, ya kodun katman diyagramı tarafından belirlenmeyen derlemesinde bağımlılığı varsa yada kodun katman diyagramı tarafından belirlenen bağımlılığı eksik ise ortaya çıkar. Bağımlılığın olup olmaması gerektiğine karar vermek için bağımlılık grafiğini veya kodu gözden geçirin. Bağımlılık grafikleri hakkında daha fazla bilgi için bkz. Nasıl yapılır: Grafik Belgelerine Gözatma ve Gezme.

3. Hataları yönetmek için bkz. Doğrulama Hatalarını Yönetme.

Kodu komut isteminden doğrulamak için

1. Visual Studio komut istemini açın.

   Komut istemini açmak için Başlat'a tıklayın, Tüm Programlar'ın üstüne gelin, Microsoft Visual Studio 2010'un üstüne gelin, Visual Studio Araçları'nın üstüne gelin ve sonra Visual Studio 2010 Komut İstemi'ne tıklayın.

2. Aşağıdakilerden birini seçin:

   • Çözümde belirli modelleme projesine karşı kodu doğrulamak için aşağıdaki özel özellikler ile MSBuild'i çalıştırın.

     msbuild <FilePath+ModelProjectFileName>.modelproj
     /p:ValidateArchitecture=true
     

     - veya -

     Modelleme projesi (.modelproj) dosyasını ve katman diyagramını içeren klasöre göz atın ve sonra MSBuild'i aşağıdaki özel özellikler ile çalıştırın.

     msbuild /p:ValidateArchitecture=true 
     

   • Çözümde tüm modelleme projelerine karşı kodu doğrulamak için MSBuild'i aşağıdaki özel özellikler ile çalıştırın:

     msbuild <FilePath+SolutionName>.sln /p:ValidateArchitecture=true 
     

     - veya -

     İçinde katman diyagramının olduğu modelleme projesini kapsaması gereken çözüm klasörüne göz atın ve sonra MSBuild'i aşağıdaki özel özellikler ile çalıştırın.

     msbuild /p:ValidateArchitecture=true
     

   Oluşan hatalar listelenecektir. MSBuild hakkında daha fazla bilgi edinmek için bkz. MSBuild and MSBuild görev.

Doğrulama hatalarını anlamak için daha fazla bilgi edinmek amacıyla bkz. Katman Doğrulama Hatalarını Anlama.

Doğrulama Hatalarını Yönetme

Geliştirme işlemi sırasında, doğrulama esnasında bildirilen çakışmaların bazılarını bastırmak isteyebilirsiniz. Örneğin, zaten belirlediğiniz veya özel senaryonuzla ilgili olmayan hataları bastırmak isteyebilirsiniz. Hatayı bastırdığınızda Team Foundation'deki çalışması öğesini kaydetmek iyi bir uygulamadır.

Doğrulama hatasından dolayı çalışma öğesi oluşturmak için

• Hata Listesi penceresinde hataya sağ tıklayın, Çalışma Öğesi Oluştur'un üzerine gelin ve sonra oluşturmak istediğiniz çalışma öğesinin türüne tıklayın.

Hata Listesi penceresindeki doğrulama hatalarını yönetmek için bu görevleri kullanın:

Kodu Yerel Yapı Sırasında Otomatik Olarak Doğrulama

Yerel yapıyı çalıştırdığınız her zaman kodu otomatik olarak doğrulamak istediğinizde bu yöntemi kullanın.

Kodu otomatik olarak yerel yapıdan doğrulamak için

• Modelleme projesi (.modelproj) dosyası açmak için metin düzenleyicisi kullanın ve sonra aşağıdaki özellikleri ekleyin:

<ValidateArchitecture>true</ValidateArchitecture>

- veya -

1. Çözüm Gezgini'nde, katman diyagramı veya diyagramları içeren modelleme projesine sağ tıklayın ve sonra Özellikler'e tıklayın.

2. Özellikler penceresinde modelleme projesinin Mimariyi Doğrulama özelliğini True'ya ayarlayın.

   Bu, doğrulama işlemi içinde modelleme projesini içerir.

3. Çözüm Gezgini içinde doğrulama için kullanmak istediğiniz katman diyagramı (.layerdiagram) dosyasına tıklayın.

4. Özellikler penceresinde diyagramın Yapı Eylemi özelliğinin Doğrula'ya ayarlı olduğundan emin olun.

   Bu, doğrulama işleminde katman diyagramı içerir.

Doğrulama hatalarını anlamak için daha fazla bilgi edinmek amacıyla bkz. Katman Doğrulama Hatalarını Anlama. Hataları yönetmek için bkz. Doğrulama Hatalarını Yönetme.

Kodu Team Foundation Yapısı Sırasında Otomatik Olarak Doğrulama

Hedeflenen tasarımla çakışmalara neden olan koddaki değişiklikleri engellemek için Team Foundation Yapısı öğesini kullanarak çalışan yapılarına ve özelleştirilmiş bir MSBuild görevi oluşturarak belirleyebileceğiniz geçitli iade etmelere sahip katman doğrulamasını dahil edin. Doğrulama hatalarını toplamak için yapı raporları kullanın.

Team Foundation Yapısı hakkında daha fazla bilgi için aşağıdaki konulara bakın:

• Overview of Team Foundation Build

• Varsayılan şablonu kullanarak bir yapı tanımlar

• Yükseltme şablonu kullanarak bir yapı tanımlar

• Oluşturma ve özel yapım işlem şablonu ile çalışma

• Çalışan yapı ilerlemesini izleme

Geçişli iade yapılarını oluşturma hakkında daha fazla bilgi için bkz. Değişiklikleri doğrulamak üzere bir Gated iade yapı tanımlayın.

Team Foundation Yapısı çalışırken kodu doğrulamak için

1. Takım Gezgini'nde yapı tanımına çift tıklayın ve sonra İşlem'i tıklatın.

2. Yapı işlemi parametreleri altında Derleme'yi genişletin ve MSBuild Değişkenleri parametresinde aşağıdakileri yazın:

   /p:ValidateArchitecture = true

Daha fazla bilgi için bkz. Varsayılan şablonu kullanarak bir yapı tanımlar.

Doğrulamayı Desteklemeyen Yapılar

Katman diyagramına dayalı doğrulamayı desteklemeyen yapılar C++ projeleri, Web siteleri, Office belgeleri ve düz metin dosyaları içerir. Böyle yapıları katmanlara bağlayabilirsiniz ancak doğrulama işlemi onları dikkate almaz. Doğrulama hataları, aralarında hiçbir bağımlılığın görünmediği ayrı katmanlara bağlanmış projelere veya derlemelere olan başvurular için görünmez. Eğer kod bu başvuruları kullanmazsa böyle başvurular bağımlılık olarak düşünülmez.

Yapının doğrulamayı destekleyip desteklemediğini doğrulamak için

1. Katman diyagramında bir veya daha çok katmanı seçin, seçiminize sağ tıklayın ve sonra Bağlantıları Görüntüleme'ye tıklayın.

2. Katman Gezgini'nde Doğrulamayı Destekler sütununa bakın.

   Eğer değer yapı bağlantısı için yanlış ise, yapı doğrulamayı desteklemez.

Katman Doğrulama ile İlgili Sorunlarda Sorun Giderme

Aşağıdaki tablo katman doğrulama sorunları ve bunların çözümünü açıklanır. Bu sorunlar, kod ve tasarım arasındaki çakışmalarla sonuçlanan hatalardan ayrılır. Hatalar hakkında daha fazla bilgi için bkz. Katman Doğrulama Hatalarını Anlama.

Ayrıca bkz.

Kavramlar

Geliştirme Sırasında Sisteminizi Doğrulama

Diğer Kaynaklar

Katman Doğrulama Hatalarını Anlama