@ Control

ASP.NET sayfa ayrıştırıcısı ve derleyicisi tarafından kullanılan kullanıcı denetimlerine (.ascx dosyaları) özgü öznitelikleri tanımlar. Bu yönerge yalnızca bu dosyalarla (kaynak kodu .ascx dosyalarında bulunan) kullanılır. Kullanıcı denetimleriyle ilgili daha fazla bilgi için, bkz. ASP.NET kullanıcı Denetimler.

<%@ Control attribute="value" [attribute="value" ... ] %>

Öznitelikler

• AutoEventWireup
  Denetim olaylarının otomatik kablolanmış olup olmadığını gösterir. Olayın otomatik kablolaması etkinleştirilmiş ise true; değilse, false olur. Varsayılan, true değeridir. Daha fazla bilgi için bkz. ASP.NET Web Sunucu Denetimi olay modeli.

• ClassName
  Denetim istendiğinde dinamik olarak derlenecek olan denetimin sınıf adını belirten dize. Bu değer, herhangi bir geçerli sınıf ismi olabilir ve tam isim uzayı sınıfını (tam yetkili sınıf ismi) içerebilir. Bu öznitelik için bir değer belirtilmemişse, derlenmiş denetimin sınıf ismi denetimin dosya ismini temel alır.

  @ Reference yönergesini kullanarak denetime atanan sınıf adı, başka bir sayfa veya denetime başvuruda bulunabilir.

• ClientIDMode
  Denetim için ClientID değerleri üretmek amacıyla kullanılacak olan algoritmayı belirtir. AutoID sayfa için varsayılan değerdir.

  Inherit denetimler için varsayılan değerdir. Bu nedenle, bir kullanıcı denetimindeki denetimler için varsayılan algoritma, kullanıcı denetiminin ClientID ayarı tarafından belirlenir. Farklı bir varsayılan değer, @ Page yönergesi veya Web.config dosyasının pages ögesindeki sayfa düzeyinde ayarlanabilir. Algoritmalar hakkında daha fazla bilgi için bkz. ClientIDMode.

• CodeBehind
  Denetim ile ilişkili olan sınıfı içeren derlenmiş dosya adını belirtir. Bu öznitelik çalışma zamanında kullanılmaz.

  Not
  Bu öznitelik, arka plan kodlama özelliğini uygulamak amacıyla ASP.NET'in önceki sürümleriyle uyumluluk için eklenmiştir.ASP.NET sürüm 2.0'da bunların yerine, CodeFile özniteliğini kaynak dosya adını belirtmek için, Inherits özniteliği ile birlikte tam nitelikli sınıf adı belirtmek için kullanmalısınız.

• CodeFile
  Denetimin başvurulan arka plan kod dosyası yolunu belirtir. Bu öznitelik Inherits özniteliği ile birlikte bir kullanıcı denetimiyle arka plan kod kaynak dosyasını ilişkilendirmek için kullanılır. Öznitelik sadece derlenmiş denetimler için geçerlidir.

• CodeFileBaseClass
  Bir denetim ve denetimin ilişkili arka plan kod sınıfı için temel sınıf yolunu belirtir. Bu öznitelik isteğe bağlıdır, ancak kullanıldığında CodeFile özniteliği de bulunmalıdır. Paylaşılan bir senaryo uygulamak istediğiniz zaman, temel bir sınıfta kullanıcı denetiminde bildirilen denetimlere başvuru yapmak için ortak alanları (ve isteğe bağlı olarak, ilişkili olayları) tanımladığınız yerde bu özelliği kullanın. Bu özelliği kullanmadan temel sınıf alanları tanımladıysanız, ASP.NET kod oluşturma modeli nedeniyle çalışma zamanında kullanıcı denetiminde bildirilen denetimler (ayrı bir kısmi sınıf saplaması içinde) için yeni üye tanımları oluşturulur ve istediğiniz senaryo çalışmaz. Ancak, temel sınıfı kullanıcı denetimiyle ilişkilendirmek için CodeFileBaseClass özniteliğini kullandıysanız ve parçalı sınıfınızı (adı Inherits özniteliğine atanan ve kaynak dosyası CodeFile özniteliği tarafından başvurulan) temel sınıftan devraldıysanız, kod oluşturduktan sonra kullanıcı denetimindeki denetimlere temel sınıf alanları başvuru yapabilir.

• CompilationMode
  Denetimin, birkaç numaralandırılmış seçenekten birini belirten bir dize kullanarak veya kullanmadan derlenmesi gerektiğini ayarlar. Always varsayılan değer olduğundan .aspx denetimleri varsayılan olarak derlenir. Detaylar için bkz. CompilationMode sabit listesi.

• CompilerOptions
  Denetimi derlemek için derleme seçenekleri içeren bir dize kullanılır. Bu, C# ve Visual Basic'te derleyici komut satırı anahtarları dizisidir. Derleme seçenekleri hakkında daha fazla bilgi için bkz. C# Derleme Seçenekleri veya Visual Temel Derleyici.

• Debug
  Denetimin hata ayıklama simgeleri ile derlenip derlenmeyeceğini gösterir. Eğer denetim hata ayıklama simgeleri ile derlenmiş olmalı ise true; aksi durumda, false'tur. Bu ayar performansı etkilediği için, sadece özniteliği geliştirme sırasında true olarak ayarlamalısınız.

• Description
  Denetim için bir metin açıklaması sağlar. Bu değer ASP.NET ayrıştırıcısı tarafından yoksayılır.

• EnableTheming
  Temaların denetimde kullanılıp kullanılmayacağını gösterir. Temalar kullanılıyorsa true; aksi durumda, false olur. Varsayılan, true değeridir.

• EnableViewState
  Görünüm durumunun denetim istekleri tarafından yönetilip yönetilmediğini gösterir. Görünüm durumu korunuyorsa true; aksi durumda false olur. Varsayılan, true değeridir.

• Explicit
  Denetim derlenirken Visual Basic Option Explicit modunun kullanılıp kullanılmadığını belirler. true, Visual Basic açık derleme seçeneğinin etkinleştirildiğini ve tüm değişkenlerin bir Dim, Private, Public veya ReDim deyimiyle belirtilmesi gerektiğini gösterir; aksi takdirde false olur. Varsayılan, false değeridir.

  Not
  Bu öznitelik Visual Basic dışındaki diller tarafından göz ardı edilir.Ayrıca, bu seçenek Machine.config yapılandırma dosyasında true olarak ayarlanır.Daha fazla bilgi için, bkz. Yapılandırma Dosyalar ve ASP.NET Yapılandırması dosyalarının.

• Inherits
  Denetimin devralması için arka plan kod sınıfı belirtir. Bu UserControl sınıfından türetilen herhangi bir sınıf olabilir. Arka plan kod sınıfı kaynak dosyası yolunu içeren CodeFile özniteliği ile kullanılır. Arka plan kod sınıfları hakkında daha fazla bilgi için bkz. ASP.NET Web sayfa kod modeli.

• Language
  Denetim içindeki tüm satır içi işleme (<% %> ve <%= %>) ve kod bildirimi blokları derlenirken kullanılan dili belirler. Değerler, Visual Basic, C# ve JScript de dahil olmak üzere tüm .NET Framework destekleyen dilleri temsil edebilir. Her denetimde yalnızca bir dil kullanılır ve belirtilir.

• LinePragmas
  Çalışma zamanının kaynak kodunda satır pragmaları oluşturup oluşturmaması gerektiğini belirler. Bunlar genellikle belirli bir kaynak dosyasında konumları işaretlemek için hata ayıklama araçları tarafından kullanılan derleyici seçenekleridir. Satır pragmaları oluşturulması gerekiyorsa true; aksi durumda, false olur.

• Src
  Denetime bağlı kodu içeren kaynak dosya yolunu belirtir. Bağlantılı kaynak dosyasında, bir sınıf veya kod bildirim blokları içinde denetiminize programlama mantığı dahil etmeyi seçebilirsiniz.

  Src özniteliğini denetime yapı sağlayıcıları bağlamak için kullanabilirsiniz. Daha fazla bilgi için, BuildProvider sınıfına bakın. Ayrıca, ASP.NET 2.0'dan önceki sürümlerde Src özniteliği arka plan kod dosyasını bir denetime bağlamak için alternatif bir yol olarak kullanılırdı. ASP.NET sürüm 2.0'da, arka plan kod kaynak dosyasını bir denetime bağlamak için tercih edilen yaklaşım, Inherits özniteliğini bir sınıf belirtmek için ve sınıfın kaynak dosyası yolunu belirtmek için CodeFile özniteliği ile birlikte kullanmaktır.

• Strict
  Denetimin Visual Basic Option Strict modu kullanılarak derlenmesi gerektiğini gösterir. Eğer Option Strict etkinleştirilmişse true; aksi takdirde false olur. Varsayılan, false değeridir.

  Not
  Bu öznitelik Visual Basic dışındaki diller tarafından göz ardı edilir.

• TargetSchema
  İçerik denetimini doğrulayan şemanın adını belirtir. Bu yalnızca açıklayıcı bir amaca hizmet eder; gerçek bir doğrulama gerçekleştirilmez ve öznitelik ayrıştırıcı tarafından yoksayılır.

• WarningLevel
  Derleyicinin uyarıları hata olarak ele almasını istediğiniz, böylece denetimin derlemesini iptal eden derleyici uyarısı seviyesini gösterir. Olası uyarı düzeyleri 0 ile 4 arasındadır. Daha fazla bilgi için bkz. WarningLevel özelliği.

Açıklamalar

Bu yönerge yalnızca kullanıcı denetimlerinde kullanılabilir. Kullanıcı denetimleri .ascx uzantılı dosyalar içinde tanımlanır. Her .ascx dosyası yalnızca bir @ Control yönergesi içerebilir. Ayrıca, @ Control yönergesi başına yalnızca bir Language özniteliği tanımlayabilirsiniz, çünkü her denetim için yalnızca bir dil kullanılabilir.

Not
@ Page yönergesi (Web sayfaları için .aspx dosyalarında kullanılan) ve @ Master yönergesi (ana sayfalar için .master dosyalarında kullanılan) gibi, @ Control yönergesi tüm kaynak dosyasına uygulanan diğer yönergelerle ortak olan bazı özniteliklere sahiptir.

@ Control yönergesine birden çok öznitelik tanımlamak için her öznitelik/değer çiftini tek bir boşlukla ayırın. Belirli bir öznitelik için özniteliği kendi değerine bağlayan eşittir işaretinin (=) her iki tarafına da boşluk koymayınız. Örnek için, bu konunun Örnek bölümüne bakın.

Örnek

Aşağıdaki kod örneği, satır içi kod dili olarak Visual Basic kullanmak için ASP.NET sayfası derleyicisi bildirir ve EnableViewState özniteliğini kullanarak HTTP istekleri tarafından görünüm durumunun kaydedilmesini devre dışı bırakır.

<%@ Control Language="VB" EnableViewState="false" %>

Ayrıca bkz.

Başvuru

Metin Şablonu Yönerge Sözdizimi

@ Page

Diğer Kaynaklar

ASP.NET Sayfası Sözdizimi

ASP.NET kullanıcı Denetimler