JavaScript IntelliSense
IntelliSense, kod çalışırken bilgileri sağlayarak daha hızlı ve daha az hatalı kod yazmanıza yardımcı olur. JavaScript Düzenleyici istemci komut dosyası ile çalışırken, IntelliSense listeler nesneler, İşlevler, özellikler ve geçerli içeriğiniz üzerinde kullanılabilen parametreleri bağlı. Tam kod için IntelliSense tarafından sağlanan açılır listeden bir kodlama seçeneği seçebilirsiniz.
IntelliSense aşağıdaki görevleri tamamlamak daha kolay hale getirir:
Üye bilgilerini bulun.
Kodunuzda doğrudan dil öğelerini ekleyin.
Kod Düzenleyicisi'ni bırakmak zorunda kalmadan içeriğiniz korur.
xml belgeleri açıklamalar ve JavaScript IntelliSense genişletilebilirlik özel IntelliSense desteği.
Yeni JavaScript dili hizmet özellikleri hakkında daha fazla bilgi için bkz: Visual Studio 2012'daki Yenilikler.
Bu konu aşağıdaki bölümleri içerir:
IntelliSense bağlam belirleme
IntelliSense bilgileri işleniyor
JavaScript IntelliSense özellikleri
JavaScript IntelliSense genişletilebilirlik
JavaScript doğrulama
IntelliSense işlevselliği hakkında daha fazla bilgi için Visual Studio, bkz: IntelliSense kullanarak.
IntelliSense bağlam belirleme
JavaScript IntelliSense geçerli komut dosyası bağlama ilgili tüm komut dosyası temel kodlama seçeneklerini sağlar. Bu komut dosyası geçerli dosyasındaki öğeleri içerir. Komut dosyası başvurularını, komut dosyası derleme başvuruları ve hizmet başvurular sayfa ilişkili başvurular gibi komut dosyanız arasında doğrudan ya da dolaylı başvurulan herhangi bir kod da içerir.
Aşağıdaki öğeler üzerinde geçerli komut dosyası bağlamı oluşturulur:
Tüm komut dosyası blokları etkin belgede tanımlı işlevler. Dosya adı uzantıları .aspx, .ascx, .master, .html ve .htm uzantılı dosyaları, satır içi kod blokları desteklenir.
scriptöğeleriyle birlikte src başka bir komut dosyasına işaret eden öznitelikleri. Hedef komut dosyasının dosya adı uzantısı .js olması gerekir.
JavaScript dosyaları kullanarak diğer JavaScript dosyalarına başvuruda bir reference yönergesi.
Genel nesneler, IntelliSense uzantıları veya Gecikmeli yüklenen komut dosyaları için başvuru grubu.
xml Web Hizmetleri başvuruları.
ScriptManager Ve ScriptManagerProxy Web uygulamasını bir asp.net ajax uygulama ise denetler.
Microsoft Ajax Kitaplığı, Bir asp.net ajax etkinleştirilmiş Web uygulamasında çalışıyorsanız.
Not
IntelliSense, html öğeleri üzerinde olay işleyicisi öznitelikleri olan veya içinde tanımlanan komut desteklenmiyor href öznitelikleri.
IntelliSense bilgileri işleniyor
JavaScript IntelliSense sağlamak için dil hizmeti aşağıdaki işlemleri gerçekleştirir:
Etkin belge başvuruları dayalı ve özyinelemeli olarak başvurulan dosyaları komut dosyası başvurularını inceleyerek temel JavaScript bağımlı dosyaların bir listesini oluşturur.
Liste erişir ve her dosya türü bilgileri ve diğer ilgili verileri toplar.
Verileri toplar ve veri ve bilgi türü için IntelliSense yapar JavaScript dili hizmetine geçirir.
IntelliSense listesini etkileyebilir ve gerektiği şekilde listeyi güncelleştirir değişiklikler için dosyaları izler. Komut dosyaları (örneğin http kullanarak başvurulan) uzak depoları üzerinde izlenen değil.
JavaScript IntelliSense özellikleri
Aşağıdaki nesneler JavaScript IntelliSense destekler:
Belge Nesnesi Modeli (dom) öğeleri
İç nesneleri
Kullanıcı tanımlı değişkenleri, işlevleri ve nesnelerinin
Başvuruları kullanarak dış dosyalarında tanımlanan nesneleri komut dosyası başvurularını, başvuru yönergeleri, ve başvuru grubu.
Belirtilen nesneler xml belgeleme yorumlarını, parametreler ve alanlar gibi.
Açıklanan standart JavaScript yorum etiketleri kullanarak nesneleri (/ /). Daha fazla bilgi için bkz. JavaScript IntelliSense genişletme.
Desteklenen nesneleri JavaScript IntelliSense genişletilebilirlik mekanizması. Daha fazla bilgi için bkz. JavaScript IntelliSense genişletme.
asp.net ajax nesneleri
IntelliSense bir nesnenin türünü belirleyemiyor olduğunda, etkin belgede tanımlayıcıları kullanarak deyimi tamamlama seçeneklerini sağlar. Daha fazla bilgi için bkz. Tanımlayıcıları deyimi tamamlama.
html dom öğeleri
JavaScript IntelliSense programlama başvuru bilgileri gibi dinamik html (dhtml) dom öğeleri sağlar body, form, ve div. Yalnızca geçerli belge ve ana sayfada bulunan öğeleri IntelliSense tarafından görüntülenir. Ayrıca JavaScript IntelliSense desteklediği window ve document nesne ve üyeleri.
İç nesneleri
JavaScript IntelliSense için özgün olarak iç nesneleri programlama başvuru bilgileri sağlar Array, String, Math, Date, ve Number. İç nesneleri hakkında daha fazla bilgi için bkz: İç nesneleri (JavaScript).
Kullanıcı tanımlı değişkenleri, işlevleri ve nesnelerinin
Bir JavaScript dosyası değiştirdiğinizde, Visual Studio taramaları açtı ve başvurulan tüm kullanılabilir kod kaynakları belirlemek için belgeler. Bu değişkenler, İşlevler ve oluşturmuş olduğunuz nesneleri içerir. Bu kaynaklar için JavaScript IntelliSense sonra kullanılabilir.
Kullanıcı tanımlı değişkenler, İşlevler ve nesneler hakkında daha fazla bilgi için bkz: Kendi nesneleri oluşturma msdn Web sitesinde.
Dış dosya başvuruları
Harici dosya başvuruları kodunuzda IntelliSense desteğini elde etmek için çeşitli türde içerebilir. Komut dosyası başvurularını, başvuru yönergeleri dış başvurulara olabilir veya başvuru grubu kullanılarak belirtilebilir.
Komut başvuruları
Bir sayfanın tüm istemci komut dosyası yazmak yerine, komut dosyası kodu içeren dış dosyaların başvuruda bulunabilir. Bu, kod sayfaları arasında yeniden kolaylaştırır ve istemci komut dosyası tarayıcı tarafından önbelleğe alınmasını etkinleştirir.
asp.net ajax etkinleştirilmiş Web sayfası ile çalışıyorsanız, bir dış komut dosyası kullanarak baþvurabilirsiniz src açılış etiketinde öznitelik bir script öğesi. src Özniteliği dış veri ya da kaynak kodunu içeren dosyanın URL'sini belirtir.
Aşağıdaki örnek kullandığı biçimlendirme gösterir src özniteliğini bir <script> bir komut dosyası başvurmak için etiket.
<script type="text/javascript" src="~/Scripts/JavaScript.js">
</script>
asp.net ajax etkinleştirilmiş Web sayfası ile çalışıyorsanız, komut dosyaları kullanarak baþvurabilirsiniz ScriptReference nesnesinin ScriptManager denetim.
Aşağıdaki örnek kullandığı biçimlendirme gösterir bir ScriptReference nesnesi içinde bir ScriptManager bir komut dosyasına başvurmak için denetim.
<asp:ScriptManager ID="ScriptManager1" runat="server">
<Scripts>
<asp:ScriptReference Path="~/Scripts/JavaScript.js" />
</Scripts>
</asp:ScriptManager>
IntelliSense, asp.net ajax Web uygulamalarında bir derleme kaynakları olarak katıştırılan komut dosyaları da destekler. Katıştırılmış komut dosyası kaynakları hakkında daha fazla bilgi için bkz: Embedding a JavaScript File as a Resource in an Assembly.
Başvuru yönergesi
A reference yönergesi sağlar Visual Studio şu anda düzenlemekte komut dosyası ve diğer komut dosyaları arasında bir ilişki kurmak için. reference Yönergesi geçerli komut dosyası komut dosyası oluşturma bağlamında komut dosyası dahil olanak verir. Bu kodu olarak dışarıdan tanımlanmış işlevler, türleri ve alanları başvurmak IntelliSense sağlar.
Oluşturduğunuz bir reference yönergesi biçiminde bir xml açıklaması. Yönergesi'den herhangi bir komut dosyasında daha önce bildirilmesi gerekir. A reference disk tabanlı komut başvurusu, derleme kökenli başvuru, başvuru hizmet tabanlı komut dosyası veya kod sayfası tabanlı başvuru yönergesi içerebilir.
Aşağıdaki örnek, disk tabanlı başvuru yönergelerini kullanma örnekleri gösterir. İlk örnekte, dil hizmet dosyasını proje dosyasını (örneğin, .jsproj) içeren aynı klasörde arar.
/// <reference path="ScriptFile1.js" />
/// <reference path="Scripts/ScriptFile2.js" />
/// <reference path="../ScriptFile3.js" />
/// <reference path="~/Scripts/ScriptFile4.js" />
Aşağıdaki örnek bir başvuru derlemesinin tabanlı komut dosyası oluşturmak nasıl gösterir.
/// <reference name "Ajax.js" assembly="System.Web.Extensions, ..." />
Aşağıdaki örnek nasıl başvurulacağını hizmet tabanlı komut dosyası gösterilmektedir:
/// <reference path="MyService.asmx" />
/// <reference path="Services/MyService.asmx" />
/// <reference path="../MyService.asmx" />
/// <reference path="~/Services/MyService.asmx" />
Not
JavaScript IntelliSense Web hizmeti (.asmx) dosyalarını Web uygulama projeleri (wap) içerdiği komut desteklenmiyor.
Aşağıdaki örnek kod sayfası tabanlı başvurmak gösterilmiştir.
/// <reference path="Default.aspx" />
/// <reference path="Admin/Default.aspx" />
/// <reference path="../Default.aspx" />
/// <reference path="~/Admin/Default.aspx" />
Aşağıdaki kurallar için geçerli bir reference yönergesi.
reference Önce herhangi bir komut dosyası xml açıklaması bildirilebilir.
Üç eğik çizgi ile xml açıklamaları sözdizimi kullanmanız gerekir. Standart açıklamaları sözdizimi (bölü) kullanılarak yapılan başvurular dikkate alınmaz.
Yönergesi yalnızca tek bir dosya veya kaynağın belirtilebilir.
Birden çok başvuru sayfası tabanlı komut dosyalarına izin verilmez.
Sayfa referansı belirtilmediği takdirde, başvuru yönergeleri başka bir türü izin verilir.
Göreceli yollar dosya adları kullanın. Tilde işlecini kullanabilirsiniz (~) uygulama kök göreli yolları yapmak için.
Mutlak yollar göz ardı edilir.
Başvurulan sayfalarındaki yönergeleri başvurusu değil işlenir — diğer bir deyişle, başvuru yönergeleri çözümlenen özyinelemeli olarak sayfalar için değil. Yalnızca sayfa tarafından doğrudan başvurulan komut dosyası bulunur.
Başvuru grubu
Başvuru grubu, kapsamdaki tüm JavaScript projeleriniz için dosyalar, belirli IntelliSense .js belirtmek için kullanabilirsiniz. Üç başvuru grubu: dolaylı (Windows) ve dolaylı (Web) ayrılmış alt başvuru grubudur. Örtülü (Windows) başvuruları olan için Windows Mağazası , JavaScript kullanarak apps ve dolaylı (Web) başvuruları HTML5 projeler için. Bu dolaylı başvuru gruplarına dahil edilen Kod Düzenleyicisi'nde açılan her .js dosya kapsamı içinde dosyalarıdır.
HTML5 Web çalışanları için ayrılmış alt başvuru grubu olur. Bu grup ile belirtilen kapsamdaki ayrılmış alt başvuru grubu için açık bir başvuru .js dosyaları için dosyalarıdır. Dolaylı başvuru ayrılmış alt başvuru grubu için açık bir başvuru .js dosyaları için geçerli değildir.
Örtük başvuruyu belirlemek için yapılandırma seçenekleri için JavaScript Kod Düzenleyicisi'ni kullanabilirsiniz. Daha fazla bilgi için bkz. Seçenekler, Text Editor JavaScript IntelliSense.
İpucu
IntelliSense başvurular genellikle IntelliSense ve genel nesneler için IntelliSense desteği sağlamak için kullanılan uzantıları.Bu özellik, komut dosyasını yükleyici kullanarak çalışma zamanında yüklenen gerekir komut dosyaları için de kullanabilirsiniz.
xml belgeleri açıklamalar
xml belgeleri açıklamalar komut dosyasına eklediğiniz metin açıklamalardır. Açıklamalı komut başvuru yaptığınızda, bu metin açıklamaları IntelliSense'de görüntülenir. Örneğin, bir işlevin parametreleri hakkında bilgi sağlar ve dönüş değeri. xml belgeleri açıklamalar yalnızca başvurulan dosyalar, derlemeler ve Hizmetleri kullanılabilir. Daha fazla bilgi için, bkz. xml belgesi açıklamalarının (JavaScript) ve Nasıl: JavaScript xml belgelerine açıklamaları oluşturma.
IntelliSense kod başvuruları xml açıklamaları için aşağıdaki dosya başvurusu senaryolarda görüntüleyebilirsiniz:
Başka bir .js dosyasına başvuran bir .js dosya.
Bir .aspx dosyası başvuran bir .js dosya.
.Js dosyasına başvuran bir .aspx dosyası.
IntelliSense, bir .aspx dosyası başka bir .aspx dosyası başvurduğunda kullanılamaz.
asp.net ajax nesneleri
asp.net ajax JavaScript IntelliSense de destekler. asp.net ajax, ECMAScript (JavaScript) kullanılabilir olan standart türler genişleten bir istemci framework içerir. asp.net ajax nesneler hakkında bilgi sağlamak JavaScript IntelliSense etkinleştirmek için xml belgeleri açıklamalar boyunca eklenmiş olan Microsoft Ajax Kitaplığı. asp.net ajax Kitaplığı'nda türleri ve içerdiği üyeleri kullandığınızda bu xml belgeleri açıklamalar görüntülenir.
Not
Özel üyelerin JavaScript IntelliSense tarafından görüntülenmez.Özel üyelerin asp.net ajax, bir alt çizgi (_) ile başlayan üye olarak belirtilir.
JavaScript IntelliSense genişletilebilirlik
JavaScript dili Servis nesneleri ve üçüncü taraf kitaplıkları kullanan geliştiriciler için IntelliSense deneyimi değiştirmenize olanak sağlayan işlevler sağlar. Bu özellikler, varsayılan dil hizmeti müşterilerine sağlamak istediğiniz tüm bilgileri sağlamak mümkün değilken, özellikle yararlıdır. Daha fazla bilgi için bkz. JavaScript IntelliSense genişletme.
JavaScript doğrulama
JavaScript komut dosyası doğrulama sürekli arka planda gerçekleşir. Zaman Visual Studio sözdizimi hataları algılarsa JavaScript kodu aşağıdaki şekillerde geribildirim sağlanır:
Altı çizili öğelerin Düzenleyicisi'nde. Dalgalı kırmızı alt çizgiler hatalarını gösterir. Fare işaretçisini hata üzerinde tutun, bir araç ipucu hata açıklamasını görüntüler.
Hata listesi pencere. Hata listesi hata açıklamasını, hatanın oluştuğu dosya, satır ve sütun numarası ve proje penceresini görüntüler. Görüntülemek için Hata listesi penceresinde, Görünüm menüsünde tıklatın Hata listesi.
Çıktı penceresini yüklü değil başvurularını gösterir.
Başa dön
Ayrıca bkz.
Görevler
Nasıl: JavaScript xml belgelerine açıklamaları oluşturma
Kavramlar
JavaScript IntelliSense genişletme
Tanımlayıcıları deyimi tamamlama
xml belgesi açıklamalarının (JavaScript)