Tags: , , , , , , , , | Categories: IDE, Programlama Posted by okutbay on 08.10.2007 12:37 | Yorumlar (0)
Kodunuzu daha okunaklı kılmak için öncelike yapmanız gereken kod bloklarınızdan önce /// (üç bölü) yazmanız ve visual studio 2005 editörünün sizin için oluşturacağı bölümleri doldurmak.

/// <summary>
/// Bu sınıf Kişi verisi ve bu veri üzerinde yapılacak işlemleri içerir.
/// </summary>

Böylece ilgili kodunuz (class, method, vb.) kullanırken Visual Studio 2005 Editörü geliştirmeyi yapan kişiye gösterdiği tooltiplerde daha fazla bilgi verebilir.

Not:İlgili Tanım bloğu ile tanımladığı kod bloğu arasında boş satır olmamalıdır. Açıklama ile kod peş peşe yer almalıdır.

Ayrıca bu oluşturduğunuz bölümleri XML dosyasına aktarabilirsiniz.

Bu işlem için derleme parametrelerinde oluşturulacak XML dosyasının adı belirtilmelidir. Bunu yapmak için proje özelliklerinde build sekmesinde XML documentation file özelliği ayarlanmalıdır.

Bu işlemden sonra derleme sonucu gerekli XML belgesi oluşur.

Bundan sonra bu XML belgesi ile ne yapacağınız size kalıyor...

Örneğin bu dosyayı piyasada bulabileceğiniz uygulamalar ile kullanıp kendi yardım dosyalarınızı oluşturabilirsiniz.

Bu programlara NDoc örnek olarak verilebilir.
http://sourceforge.net/projects/ndoc/

Ayrıca bir XSL yardımı ile XML dosyanızın daha anlamlı görüntülenmesini de sağlayabilirsiniz...
http://www.codeproject.com/soap/XMLDocStylesheet.asp


Klavyeler şen ola...

Bu yazıyı ilk değerlendiren siz olun

  • Currently 0/5 Stars.
  • 1
  • 2
  • 3
  • 4
  • 5
Tags: , , , , | Categories: Hata, IDE, Web Uygulaması Posted by okutbay on 06.07.2007 08:57 | Yorumlar (0)

Geçenlerde Bursa Datahouse eğitim firmasında bir eğitim sırasında web.config dosyasına eklemek istediğimiz bir elemanı yazmaya başladığımızda intellisense özelliği bize önerilerde bulunmamış ve yarı yolda bırakmıştı. Biz de klavyemize kuvvet yazmıştık. Akabinde eğitimi takip eden arkadaşlardan birisi bunun "Web Site Administration Tool (WSAT)" a girdikten sonra gerçekleştiğini söylemişti.

Figür 1: Kaybolan Intellisense
Not: Web Site Administration Tool, basit bir web arayüzü ile uygulamanızla ilgili ayarlarınızı yapabilmeniz için .NET Framework 2.0 ile sağlanan bir araçtır. Visual Studio 2005 içinde "Website > ASP.NET Configuration" menü seçeneği ile ulaşabilirsiniz.

Gerçekten de WSAT a girdikten sonra web.config dosyamda intellisense kullanarak düzenleme yapamamaya başlamıştım.

Varsayılan bir web.config ile karşılaştırma yaptıktan sonra sorunun aracın eklediği XML Namespace tanımından kaynaklandığını farkettim.

Sorunu düzeltmek için configuration elemanında tanımlanan xmlns özniteliğini (attribute) kaldırmak yeterli oldu.
<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">

elemanını

<configuration>

şeklinde düzeltebilirsiniz...

Figür 2: Intellisense tekrar çalışıyor



Klavyeler şen ola...

Bu yazıyı ilk değerlendiren siz olun

  • Currently 0/5 Stars.
  • 1
  • 2
  • 3
  • 4
  • 5