İçerik Sayfalarında Denetim Kimliği Adlandırma (C#)

tarafından Scott Mitchell

PDF’yi İndir

ContentPlaceHolder denetimlerinin adlandırma kapsayıcısı olarak nasıl çalıştığını ve bu nedenle bir denetimle program aracılığıyla çalışmayı nasıl zorlaştıracaklarını gösterir (FindControl aracılığıyla). Bu soruna ve geçici çözümlere göz atabilirsiniz. Ayrıca, sonuçta elde edilen ClientID değerine program aracılığıyla erişmeyi de açıklar.

Giriş

Tüm ASP.NET sunucu denetimleri, denetimi benzersiz olarak tanımlayan ve ID arkadaki kod sınıfında denetime program aracılığıyla erişilen bir özellik içerir. Benzer şekilde, bir HTML belgesindeki öğeler öğeyi benzersiz olarak tanımlayan bir id öznitelik içerebilir; bu id değerler genellikle istemci tarafı betiğinde belirli bir HTML öğesine program aracılığıyla başvurmak için kullanılır. Bunu göz önünde bulundurarak, bir ASP.NET sunucu denetimi HTML olarak işlendiğinde, değerinin ID işlenen HTML öğesinin id değeri olarak kullanıldığını varsayabilirsiniz. Belirli durumlarda tek bir değere sahip tek bir ID denetim işlenen işaretlemede birden çok kez görünebileceğinden, bu durum her zaman böyle olmayabilir. ProductName değerine sahip Label Web denetimine sahip TemplateField içeren bir ID GridView denetimi düşünün. GridView çalışma zamanında veri kaynağına bağlı olduğunda, bu Etiket her GridView satırı için bir kez yinelenir. İşlenen her Etiket için benzersiz id bir değer gerekir.

bu tür senaryoları işlemek için, ASP.NET bazı denetimlerin adlandırma kapsayıcıları olarak belirtilmesine izin verir. Adlandırma kapsayıcısı yeni ID bir ad alanı görevi görür. Adlandırma kapsayıcısında görünen tüm sunucu denetimlerinin işlenen id değeri, adlandırma kapsayıcısı denetiminin ID ön ekiyle gösterilir. Örneğin, GridView ve GridViewRow sınıflarının her ikisi de adlandırma kapsayıcılarıdır. Sonuç olarak, ProductName ile ID GridView TemplateField içinde tanımlanan etiket denetimine GridViewID_GridViewRowID_ProductNameişlenmiş id değeri verilir. GridViewRowID her GridView satırı için benzersiz olduğundan, sonuçta elde edilen id değerler benzersizdir.

Not

ArabirimINamingContainer, belirli bir ASP.NET sunucu denetiminin adlandırma kapsayıcısı olarak çalışması gerektiğini belirtmek için kullanılır. Arabirim, INamingContainer sunucu denetiminin uygulaması gereken hiçbir yöntemi belirtmez; bunun yerine işaretçi olarak kullanılır. İşlenen işaretlemeyi oluştururken, bir denetim bu arabirimi uygularsa ASP.NET altyapısı otomatik olarak değerini alt bileşenlerinin işlenen id öznitelik değerlerine öneklerID. Bu işlem 2. Adım'da daha ayrıntılı olarak ele alınmıştı.

Kapsayıcıları adlandırmak yalnızca işlenen id öznitelik değerini değiştirmekle kalmaz, aynı zamanda denetime ASP.NET sayfasının arka kod arkası sınıfından program aracılığıyla nasıl başvurulabileceğini de etkiler. FindControl("controlID") yöntemi genellikle bir Web denetimine program aracılığıyla başvurmak için kullanılır. Ancak, FindControl adlandırma kapsayıcıları aracılığıyla nüfuz etmez. Sonuç olarak, gridview veya başka bir adlandırma kapsayıcısı Page.FindControl içindeki denetimlere başvurmak için yöntemini doğrudan kullanamazsınız.

Tahmin ettiğiniz gibi ana sayfalar ve ContentPlaceHolder'lar adlandırma kapsayıcıları olarak uygulanır. Bu öğreticide, ana sayfaların HTML öğesi id değerlerini nasıl etkilediğini ve kullanarak FindControliçerik sayfasındaki Web denetimlerine program aracılığıyla başvurma yollarını inceleyeceğiz.

1. Adım: Yeni ASP.NET Sayfası Ekleme

Bu öğreticide ele alınan kavramları göstermek için web sitemize yeni bir ASP.NET sayfası ekleyelim. Kök klasörde adlı IDIssues.aspx ve ana sayfaya Site.master bağlayan yeni bir içerik sayfası oluşturun.

Şekil 01: İçerik Sayfasını IDIssues.aspx Kök Klasöre Ekleme

Visual Studio, ana sayfanın dört ContentPlaceHolder'ının her biri için otomatik olarak bir İçerik denetimi oluşturur. Birden Çok ContentPlaceHolder ve Varsayılan İçerik öğreticisinde belirtildiği gibi, İçerik denetimi yoksa bunun yerine ana sayfanın varsayılan ContentPlaceHolder içeriği yayılır. QuickLoginUI ve LeftColumnContent ContentPlaceHolder'lar bu sayfa için uygun varsayılan işaretlemeler içerdiğinden, devam edin ve ilgili İçerik denetimlerini 'den IDIssues.aspxkaldırın. Bu noktada, içerik sayfasının bildirim temelli işaretlemesi aşağıdaki gibi görünmelidir:

<%@ Page Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="IDIssues.aspx.cs" Inherits="IDIssues" Title="Untitled Page" %>

<asp:Content ID="Content1" ContentPlaceHolderID="head" Runat="Server">
</asp:Content>

<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" Runat="Server">
</asp:Content>

Ana Sayfadaki Başlık, Meta Etiketler ve Diğer HTML Üst Bilgilerini Belirtme öğreticisinde, açıkça ayarlanmazsa sayfanın başlığını otomatik olarak yapılandıran özel bir temel sayfa sınıfı (BasePage) oluşturduk. IDIssues.aspx Sayfanın bu işlevi kullanabilmesi için, sayfanın arka planda kod sınıfının sınıfından BasePage türetilmiş olması gerekir (yerineSystem.Web.UI.Page). Arka planda kod sınıfının tanımını aşağıdaki gibi görünecek şekilde değiştirin:

public partial class IDIssues : BasePage
{
}

Son olarak, dosyayı bu yeni ders için bir girdi içerecek şekilde güncelleştirin Web.sitemap . Bir <siteMapNode> öğe ekleyin ve ve titleurl özniteliklerini sırasıyla "Denetim Kimliği Adlandırma Sorunları" ve ~/IDIssues.aspxolarak ayarlayın. Bu ekleme tamamlandıktan sonra dosyanızın Web.sitemap işaretlemesi aşağıdakine benzer görünmelidir:

<?xml version="1.0" encoding="utf-8" ?>
<siteMap xmlns="http://schemas.microsoft.com/AspNet/SiteMap-File-1.0" >
 <siteMapNode url="~/Default.aspx" title="Home">
 <siteMapNode url="~/About.aspx" title="About the Author" />
 <siteMapNode url="~/MultipleContentPlaceHolders.aspx" title="Using Multiple ContentPlaceHolder Controls" />
 <siteMapNode url="~/Admin/Default.aspx" title="Rebasing URLs" />
 <siteMapNode url="~/IDIssues.aspx" title="Control ID Naming Issues" />
 </siteMapNode>
</siteMap>

Şekil 2'de gösterildiği gibi, içindeki Web.sitemap yeni site haritası girişi hemen sol sütundaki Dersler bölümüne yansıtılır.

Şekil 02: Dersler Bölümü Artık "Denetim Kimliği Adlandırma Sorunları" bağlantısını içerir

2. Adım: İşlenenIDDeğişiklikleri inceleme

ASP.NET altyapısının sunucu denetimlerinin işlenmiş id değerlerinde yaptığı değişiklikleri daha iyi anlamak için sayfaya IDIssues.aspx birkaç Web denetimi ekleyelim ve ardından tarayıcıya gönderilen işlenmiş işaretlemeyi görüntüleyelim. Özellikle, "Lütfen yaşınızı girin:" metnini ve ardından bir TextBox Web denetimi yazın. Sayfanın daha aşağı kısmında Düğme Web denetimi ve Etiket Web denetimi ekleyin. TextBox'ın ID ve Columns özelliklerini Age sırasıyla ve 3 olarak ayarlayın. Düğmenin Text ve ID özelliklerini "Gönder" ve SubmitButtonolarak ayarlayın. Label Text özelliğini temizleyin ve olarak IDResultsayarlayın.

Bu noktada İçerik denetiminizin bildirim temelli işaretlemesi aşağıdakine benzer olmalıdır:

<p>
 Please enter your age:
 <asp:TextBox ID="Age" Columns="3" runat="server"></asp:TextBox>
</p>
<p>
 <asp:Button ID="SubmitButton" runat="server" Text="Submit" />
</p>
<p>
 <asp:Label ID="Results" runat="server"></asp:Label>
</p>

Şekil 3'te, Visual Studio tasarımcısı aracılığıyla görüntülendiğinde sayfa gösterilir.

Şekil 03: Sayfa Üç Web Denetimi içerir: TextBox, Düğme ve Etiket (Tam boyutlu görüntüyü görüntülemek için tıklayın)

Sayfayı bir tarayıcı üzerinden ziyaret edin ve ardından HTML kaynağını görüntüleyin. Aşağıdaki işaretlemede gösterildiği gibi, id TextBox, Button ve Label Web denetimleri için HTML öğelerinin ID değerleri, Web denetimlerinin değerleriyle ID sayfadaki adlandırma kapsayıcılarının değerlerinin bir birleşimidir.

<p>
 Please enter your age:
 <input name="ctl00$MainContent$Age" type="text" size="3" id="ctl00_MainContent_Age" />
</p>
<p>

 <input type="submit" name="ctl00$MainContent$SubmitButton" value="Submit" id="ctl00_MainContent_SubmitButton" />
</p>
<p>
 <span id="ctl00_MainContent_Results"></span>
</p>

Bu öğreticide daha önce belirtildiği gibi, hem ana sayfa hem de ContentPlaceHolder'ları adlandırma kapsayıcıları olarak hizmet verir. Sonuç olarak, her ikisi de iç içe denetimlerinin işlenmiş ID değerlerine katkıda bulunur. TextBox özniteliğini id alın, örneğin: ctl00_MainContent_Age. TextBox denetiminin değerinin ID olduğunu Agehatırlayın. Bu, ContentPlaceHolder denetiminin ID değeri olan ön MainContentekini alır. Ayrıca, bu değer ana sayfanın ID değeri ctl00olan ön ekini alır. Net etkisi, ana sayfanın, ContentPlaceHolder denetiminin ve TextBox'ın kendisinden oluşan ID bir id öznitelik değeridir.

Şekil 4'de bu davranış gösterilmektedir. TextBox'ın işlenenini idAge belirlemek için TextBox denetiminin IDAgedeğeriyle başlayın. Ardından, denetim hiyerarşisinde yukarı doğru çalışın. Her adlandırma kapsayıcısında (şeftali rengine sahip düğümler), işlenen geçerli id kapsayıcının ön ekini adlandırma kapsayıcısının idönüne koyun.

Şekil 04: İşlenen id Öznitelikler Adlandırma Kapsayıcılarının Değerlerini Temel ID Alır

Not

Ele aldığımız gibi, ctl00 işlenen id özniteliğin bölümü ana sayfanın değerini oluşturur ID , ancak bu ID değerin nasıl ortaya geldiğini merak ediyor olabilirsiniz. Ana sayfamızın veya içerik sayfamızın hiçbir yerinde belirtmedik. bir ASP.NET sayfasındaki çoğu sunucu denetimi, sayfanın bildirim temelli işaretlemesi aracılığıyla açıkça eklenir. MainContent ContentPlaceHolder denetimi işaretlemesinde Site.masteraçıkça belirtildi; Age TextBox'ın işaretlemesi tanımlandıIDIssues.aspx. Bu denetim türlerinin ID değerlerini Özellikler penceresi veya bildirim temelli söz diziminden belirtebiliriz. Ana sayfanın kendisi gibi diğer denetimler bildirim temelli işaretlemede tanımlanmaz. Sonuç olarak, değerleri ID bizim için otomatik olarak oluşturulmalıdır. ASP.NET altyapısı, kimlikleri açıkça ayarlanmamış denetimler için çalışma zamanındaki değerleri ayarlar ID . Adlandırma desenini ctlXXkullanır; burada XX , sıralı olarak artan bir tamsayı değeridir.

Ana sayfanın kendisi bir adlandırma kapsayıcısı görevi üstlendiği için, ana sayfada tanımlanan Web denetimleri de işlenmiş öznitelik değerlerini değiştirmektedir id . Örneğin, DisplayDateAna Sayfalarla Site-Wide Düzeni Oluşturma öğreticisindeki ana sayfaya eklediğimiz Etiket aşağıdaki işlenmiş işaretlemeye sahiptir:

<span id="ctl00_DateDisplay">current date</span>

özniteliğinin id hem ana sayfanın ID değerini (ctl00) hem de ID Label Web denetiminin (DateDisplay ) değerini içerdiğini unutmayın.

3. Adım: Aracılığıyla Program Aracılığıyla Web Denetimlerine BaşvurmaFindControl

Her ASP.NET sunucu denetimi, denetimin alt öğelerinde controlID adlı bir denetim arayan bir yöntem içerirFindControl("controlID"). Böyle bir denetim bulunursa döndürülür; Eşleşen bir denetim bulunmazsa döndürür FindControlnull.

FindControl bir denetime erişmeniz gereken ancak denetime doğrudan başvuruya sahip olmadığınız senaryolarda kullanışlıdır. Örneğin GridView gibi veri Web denetimleriyle çalışırken GridView'un alanlarındaki denetimler bildirim temelli söz diziminde bir kez tanımlanır, ancak çalışma zamanında her GridView satırı için denetimin bir örneği oluşturulur. Sonuç olarak, çalışma zamanında oluşturulan denetimler vardır, ancak arka planda kod sınıfından doğrudan başvuru sağlanmaz. Sonuç olarak, GridView'ın alanlarındaki belirli bir denetimle program aracılığıyla çalışmak için kullanmamız FindControl gerekir. (Veri Web denetiminin şablonlarındaki denetimlere erişmek için kullanma FindControl hakkında daha fazla bilgi için bkz. Verilere Göre Özel Biçimlendirme.) Bu senaryo, Dinamik Veri Girişi Kullanıcı Arabirimleri Oluşturma başlığında ele alınan bir konu olan Web Formu'na dinamik olarak Web denetimleri eklerken de oluşur.

bir içerik sayfasındaki denetimleri aramak için yönteminin kullanılmasını FindControl göstermek için, 'nin Click olayı için SubmitButtonbir olay işleyicisi oluşturun. Olay işleyicisine, yöntemini kullanarak FindControl TextBox ve Label'a program aracılığıyla başvuran Age ve Results ardından kullanıcının girişini temel alan bir ileti Results görüntüleyen aşağıdaki kodu ekleyin.

Not

Elbette, bu örnekte Label ve TextBox denetimlerine başvurmak için kullanmamız FindControl gerekmez. Bunlara doğrudan özellik değerleri aracılığıyla ID başvurabiliriz. İçerik sayfasından kullanırken FindControl neler olduğunu göstermek için burayı kullanıyorumFindControl.

protected void SubmitButton_Click(object sender, EventArgs e)
{
    Label ResultsLabel = FindControl("Results") as Label;
    TextBox AgeTextBox = Page.FindControl("Age") as TextBox;

    ResultsLabel.Text = string.Format("You are {0} years old!", AgeTextBox.Text);
}

yöntemini çağırmak için kullanılan söz dizimi, öğesinin FindControl ilk iki satırı SubmitButton_Clickarasında biraz farklılık gösterse de, bunlar eşanlamlı olarak eşdeğerdir. Tüm ASP.NET sunucu denetimlerinin bir yöntem içerdiğini FindControl hatırlayın. Bu, tüm ASP.NET arka planda kod sınıflarının türetilmiş olması gereken sınıfını içerir Page . Bu nedenle, FindControl("controlID") arkadaki kod sınıfınızda veya özel bir temel sınıfta yöntemini geçersiz kılmadığınız FindControl varsayılarak çağrısı ile Page.FindControl("controlID")eşdeğerdir.

Bu kodu girdikten sonra tarayıcı üzerinden sayfayı IDIssues.aspx ziyaret edin, yaşınızı girin ve "Gönder" düğmesine tıklayın. "Gönder" düğmesine tıklandığında bir NullReferenceException oluşturulur (bkz. Şekil 5).

Şekil 05: A NullReferenceException Yükseltilmiş (Tam boyutlu görüntüyü görüntülemek için tıklayın)

Olay işleyicisinde SubmitButton_Click bir kesme noktası ayarlarsanız, her iki çağrının FindControl da bir null değer döndürdüğünü görürsünüz. NullReferenceException, TextBox'ın Text özelliğine Age erişmeye çalışırken oluşturulur.

Sorun, denetiminControl.FindControl yalnızca aynı adlandırma kapsayıcısında bulunan alt öğelerinde arama yaptığıdır. Ana sayfa yeni bir adlandırma kapsayıcısı oluşturduğundan, ana sayfa nesnesine ctl00hiçbir zaman geçirilmeme Page.FindControl("controlID") çağrısı yapılır. (Nesneyi ana sayfa ctl00nesnesinin üst öğesi olarak gösteren denetim hiyerarşisini Page görüntülemek için Şekil 4'e geri bakın.) Bu nedenle, Results Label ve Age TextBox bulunmaz ve AgeTextBoxResultsLabel değerlerine nullatanır.

Bu sınamanın iki geçici çözümü vardır: bir kerede bir adlandırma kapsayıcısını uygun denetime kadar detaya gidebiliriz; veya adlandırma kapsayıcılarını kullanan kendi FindControl yöntemimizi oluşturabiliriz. Şimdi bu seçeneklerin her birini inceleyelim.

Uygun Adlandırma Kapsayıcısında Detaya Gitme

Label veya Age TextBox'a Results başvurmak için kullanmak FindControl için aynı adlandırma kapsayıcısında bir ata denetiminden çağrısı FindControl yapmamız gerekir. Şekil 4'ün gösterdiği gibi ContentPlaceHolder MainContent denetimi, aynı adlandırma kapsayıcısının içindeki veya Age öğesinin tek atasıdırResults. Başka bir deyişle, aşağıdaki kod parçacığında gösterildiği gibi denetimden MainContent yöntemini çağırmakFindControl, veya Age denetimlerine Results doğru bir başvuru döndürür.

Label ResultsLabel = MainContent.FindControl("Results") as Label;
TextBox AgeTextBox = MainContent.FindControl("Age") as TextBox;

Ancak contentPlaceHolder ana sayfada tanımlandığından yukarıdaki söz dizimini kullanarak içerik sayfamızın arka kod sınıfındaki ContentPlaceHolder ile MainContent çalışamıyoruz. Bunun yerine, öğesine bir başvuru almak için MainContentkomutunu kullanmalıyızFindControl. Olay işleyicisindeki SubmitButton_Click kodu aşağıdaki değişikliklerle değiştirin:

protected void SubmitButton_Click(object sender, EventArgs e)
{
    ContentPlaceHolder MainContent = FindControl("MainContent") as ContentPlaceHolder;

    Label ResultsLabel = MainContent.FindControl("Results") as Label;
    TextBox AgeTextBox = MainContent.FindControl("Age") as TextBox;

    ResultsLabel.Text = string.Format("You are {0} years old!", AgeTextBox.Text);
}

Sayfayı bir tarayıcı üzerinden ziyaret ederseniz yaşınızı girin ve "Gönder" düğmesine tıklarsanız bir NullReferenceException oluşturulur. Olay işleyicisinde SubmitButton_Click bir kesme noktası ayarlarsanız, nesnenin FindControl yöntemini çağırmaya çalışırken bu özel durumun oluştuğunı MainContent görürsünüz. Nesnesinin MainContent nedeni yönteminin FindControl "MainContent" adlı bir nesneyi bulamamasıdırnull. Temeldeki neden Label ve Age TextBox denetimleriyle Results aynıdır: FindControl aramasını denetim hiyerarşisinin en üstünden başlatır ve adlandırma kapsayıcılarına nüfuz etmez, ancak MainContent ContentPlaceHolder bir adlandırma kapsayıcısı olan ana sayfanın içindedir.

'a başvuru almak için MainContentkullanmadan FindControl önce ana sayfa denetimine bir başvuruya ihtiyacımız vardır. Ana sayfaya bir başvuru elde ettikten sonra, ve aracılığıyla ContentPlaceHolder'a MainContentFindControl bir başvuru alacağız, buradan Label ve Age TextBox'a Results başvurular (yine kullanarakFindControl). Peki ana sayfaya nasıl başvuru alacağız? İşlenmiş işaretlemedeki öznitelikleri inceleyerek id ana sayfanın ID değerinin olduğu ctl00açıktır. Bu nedenle, ana sayfaya bir başvuru almak için kullanabilir Page.FindControl("ctl00") , sonra bu nesneyi kullanarak öğesine başvuru MainContentalabilir ve bu şekilde devam edebiliriz. Aşağıdaki kod parçacığı bu mantığı gösterir:

// Get a reference to the master page
MasterPage ctl00 = FindControl("ctl00") as MasterPage;

// Get a reference to the ContentPlaceHolder
ContentPlaceHolder MainContent = ctl00.FindControl("MainContent") as ContentPlaceHolder;

// Reference the Label and TextBox controls
Label ResultsLabel = MainContent.FindControl("Results") as Label;
TextBox AgeTextBox = MainContent.FindControl("Age") as TextBox;

Bu kod kesinlikle işe yarasa da, ana sayfanın otomatik olarak oluşturulan ID her zaman olacağını ctl00varsayar. Otomatik olarak oluşturulan değerler hakkında varsayımlarda bulunmak hiçbir zaman iyi bir fikir olmaz.

Neyse ki, ana sayfa başvurusuna sınıfın PageMaster özelliği üzerinden erişilebilir. Bu nedenle, ContentPlaceHolder'a erişmek MainContent için ana sayfa başvurusu almak için kullanmak FindControl("ctl00") yerine kullanabilirizPage.Master.FindControl("MainContent"). Olay işleyicisini SubmitButton_Click aşağıdaki kodla güncelleştirin:

protected void SubmitButton_Click(object sender, EventArgs e)
{
    ContentPlaceHolder MainContent = Page.Master.FindControl("MainContent") as ContentPlaceHolder;

    Label ResultsLabel = MainContent.FindControl("Results") as Label;
    TextBox AgeTextBox = MainContent.FindControl("Age") as TextBox;

    ResultsLabel.Text = string.Format("You are {0} years old!", AgeTextBox.Text);
}

Bu kez, sayfayı bir tarayıcı üzerinden ziyaret ederek yaşınızı girin ve "Gönder" düğmesine tıkladığınızda, ileti etikette Results beklendiği gibi görüntülenir.

Şekil 06: Kullanıcının Yaşı Etikette Görüntülenir (Tam boyutlu resmi görüntülemek için tıklayın)

Adlandırma Kapsayıcıları Aracılığıyla Özyinelemeli Arama

Önceki kod örneğinin ana sayfadan MainContent ContentPlaceHolder denetimine başvurmasının ve ardından Results içindeki Label ve Age TextBox denetimlerinin MainContentnedeni, yöntemin Control.FindControl yalnızca Control'ün adlandırma kapsayıcısında aramasıdır. İki FindControl farklı adlandırma kapsayıcısında bulunan iki denetim aynı ID değerlere sahip olabileceğinden, çoğu senaryoda adlandırma kapsayıcısının içinde kalmak mantıklıdır. TemplateFields içinde adlı ProductName bir Label Web denetimini tanımlayan gridview örneğini düşünün. Veriler çalışma zamanında GridView'a bağlı olduğunda, her GridView satırı için bir ProductName Etiket oluşturulur. Tüm adlandırma kapsayıcıları arasında arama yapılıp çağrıldıysa FindControlPage.FindControl("ProductName")hangi Etiket örneği döndürülmelidir FindControl ? ProductName İlk GridView satırındaki Etiket mi? Son satırdaki mi?

Bu nedenle çoğu durumda yalnızca Control'ün adlandırma kapsayıcısında arama yapmak Control.FindControl mantıklıdır. Ancak, tüm adlandırma kapsayıcılarında benzersiz ID bir örneğimiz olduğu ve bir denetime erişmek için denetim hiyerarşisindeki her adlandırma kapsayıcısına titizlikle başvurmak zorunda kalmamak istediğimiz bize dönük durum gibi başka durumlar da vardır. Tüm adlandırma kapsayıcılarını özyinelemeli olarak arayan bir FindControl değişkene sahip olmak da mantıklıdır. Ne yazık ki, .NET Framework böyle bir yöntem içermez.

İyi haber, tüm adlandırma kapsayıcılarını özyinelemeli olarak arayan kendi FindControl yöntemimizi oluşturabiliyor olmamızdır. Aslında, uzantı yöntemlerini kullanarak mevcut FindControl yöntemine eşlik etmek için sınıfına Control bir FindControlRecursive yönteme bağlanabiliriz.

Not

Uzantı yöntemleri, .NET Framework sürüm 3.5 ve Visual Studio 2008 ile birlikte gelen diller olan C# 3.0 ve Visual Basic 9'da yeni bir özelliktir. Kısacası, uzantı yöntemleri bir geliştiricinin özel bir söz dizimi aracılığıyla mevcut bir sınıf türü için yeni bir yöntem oluşturmasına olanak sağlar. Bu yararlı özellik hakkında daha fazla bilgi için , Temel Tür İşlevselliğini Uzantı Yöntemleriyle Genişletme makaleme bakın.

Uzantı yöntemini oluşturmak için adlı PageExtensionMethods.csklasöre App_Code yeni bir dosya ekleyin. giriş olarak adlı bir parametre alan adlı FindControlRecursivecontrolIDbir string uzantı yöntemi ekleyin. Uzantı yöntemlerinin düzgün çalışması için sınıfın ve uzantı yöntemlerinin işaretlenmesi staticçok önemlidir. Ayrıca, tüm uzantı yöntemlerinin ilk parametresi olarak uzantı yönteminin uygulandığı türde bir nesneyi kabul etmesi ve bu giriş parametresinden önce anahtar sözcüğünü thisiçermesi gerekir.

Bu sınıfı ve FindControlRecursive uzantı yöntemini tanımlamak için sınıf dosyasına aşağıdaki kodu PageExtensionMethods.cs ekleyin:

using System;
using System.Web;
using System.Web.UI;

public static class PageExtensionMethods
{
    public static Control FindControlRecursive(this Control ctrl, string controlID)
    {
        if (string.Compare(ctrl.ID, controlID, true) == 0)
        {
            // We found the control!
            return ctrl;
        }
        else
        {
            // Recurse through ctrl's Controls collections
            foreach (Control child in ctrl.Controls)
            {
                Control lookFor = FindControlRecursive(child, controlID);

                if (lookFor != null)
                    return lookFor;  // We found the control
            }

            // If we reach here, control was not found
            return null;
        }
    }
}

Bu kod mevcut olduğunda, sayfanın arka planda kod sınıfına IDIssues.aspx dönün ve geçerli FindControl yöntem çağrılarını açıklama satırı yapma. bunları çağrısıyla Page.FindControlRecursive("controlID")değiştirin. Uzantı yöntemlerinin en iyi özelliği, bunların doğrudan IntelliSense açılan listelerinde görünmesidir. Şekil 7'de gösterildiği gibi, Page yazıp isabet dönemi yazdığınızda, FindControlRecursive yöntem diğer Control sınıf yöntemleriyle birlikte IntelliSense açılan menüsüne eklenir.

Şekil 07: Uzantı Yöntemleri IntelliSense Drop-Downs Dahil Edilir (Tam boyutlu görüntüyü görüntülemek için tıklayın)

Olay işleyicisine SubmitButton_Click aşağıdaki kodu girin ve ardından sayfayı ziyaret ederek, yaşınızı girerek ve "Gönder" düğmesine tıklayarak bunu test edin. Şekil 6'da gösterildiği gibi, sonuçta elde edilen çıkış "Yaşınız geçti!" iletisi olacaktır.

protected void SubmitButton_Click(object sender, EventArgs e)
{
    Label ResultsLabel = Page.FindControlRecursive("Results") as Label;
    TextBox AgeTextBox = Page.FindControlRecursive("Age") as TextBox;

    ResultsLabel.Text = string.Format("You are {0} years old!", AgeTextBox.Text);
}

Not

Uzantı yöntemleri C# 3.0 ve Visual Basic 9'da yeni olduğundan, Visual Studio 2005 kullanıyorsanız uzantı yöntemlerini kullanamazsınız. Bunun yerine yöntemini bir yardımcı sınıfında uygulamanız FindControlRecursive gerekir. Rick Strahl'ın blog gönderisinde Maser Pages ve FindControlASP.NET böyle bir örneği var.

4. Adım: Client-Side Betiğinde DoğruidÖznitelik Değerini Kullanma

Bu öğreticinin girişinde belirtildiği gibi, bir Web denetiminin işlenen id özniteliği genellikle istemci tarafı betiğinde belirli bir HTML öğesine program aracılığıyla başvurmak için kullanılır. Örneğin, aşağıdaki JavaScript bir HTML öğesine kendi tarafından id başvurur ve değerini kalıcı bir ileti kutusunda görüntüler:

var elem = document.getElementById("Age");
if (elem != null)
    alert("You entered " + elem.value + " into the Age text box.");

Adlandırma kapsayıcısı içermeyen ASP.NET sayfalarda, işlenen HTML öğesinin id özniteliğinin Web denetiminin ID özellik değeriyle aynı olduğunu unutmayın. Bu nedenle öznitelik değerlerinde JavaScript koduna id sabit kod eklemek cazip bir işlemdir. Diğer bir ifadeyle, TextBox Web denetimine istemci tarafı betiği aracılığıyla erişmek Age istediğinizi biliyorsanız, bunu çağrısıyla document.getElementById("Age")yapın.

Bu yaklaşımdaki sorun, ana sayfaları (veya diğer adlandırma kapsayıcısı denetimlerini) kullanırken işlenen HTML'nin idID Web denetiminin özelliğiyle eş anlamlı olmamasıdır. İlk eğiliminiz, bir tarayıcı aracılığıyla sayfayı ziyaret etmek ve gerçek id özniteliği belirlemek için kaynağı görüntülemek olabilir. İşlenen id değeri bildiğinizde, istemci tarafı betiği aracılığıyla birlikte çalışmanız gereken HTML öğesine erişmek için çağrısına getElementById yapıştırabilirsiniz. Sayfanın denetim hiyerarşisinde yapılan bazı değişiklikler veya adlandırma denetimlerinin özelliklerinde yapılan değişiklikler ID sonuçta id elde edilen özniteliği değiştirip JavaScript kodunuzu bozacağından bu yaklaşım idealden daha düşüktür.

İyi haber, id işlenen öznitelik değerinin Web denetiminin ClientID özelliği aracılığıyla sunucu tarafı kodunda erişilebilir olmasıdır. İstemci tarafı betiğinde id kullanılan öznitelik değerini belirlemek için bu özelliği kullanmalısınız. Örneğin, çağrıldığında TextBox değerini Age kalıcı bir ileti kutusunda görüntüleyen sayfaya bir JavaScript işlevi eklemek için olay işleyicisine Page_Load aşağıdaki kodu ekleyin:

ClientScript.RegisterClientScriptBlock(this.GetType(), "ShowAgeTextBoxScript",
 string.Format(@"function ShowAge()
 {{
 var elem = document.getElementById('{0}');
 if (elem != null)
 alert('You entered ' + elem.value + ' into the Age text box.');
 }}", AgeTextBox.ClientID), true);

Yukarıdaki kod, TextBox'ın ClientID özelliğinin Age değerini JavaScript çağrısına ekler getElementById. Bu sayfayı bir tarayıcı üzerinden ziyaret edip HTML kaynağını görüntülerseniz aşağıdaki JavaScript kodunu bulursunuz:

<script type="text/javascript">
//<![CDATA[
function ShowAge()
{
 var elem = document.getElementById('ctl00_MainContent_Age');
 if (elem != null)
 alert('You entered ' + elem.value + ' into the Age text box.');
}//]]>
</script>

doğru id öznitelik değerinin çağrısı ctl00_MainContent_Ageiçinde nasıl göründüğüne getElementByIddikkat edin. Bu değer çalışma zamanında hesaplandığından, sayfa denetimi hiyerarşisinde daha sonra yapılan değişikliklerden bağımsız olarak çalışır.

Not

Bu JavaScript örneği yalnızca bir sunucu denetimi tarafından işlenen HTML öğesine doğru başvuruda bulunan bir JavaScript işlevinin nasıl ekleneceğini gösterir. Bu işlevi kullanmak için, belge yüklendiğinde veya belirli bir kullanıcı eylemi tamamlandığında işlevi çağırmak için ek JavaScript yazmanız gerekir. Bu konular ve ilgili konular hakkında daha fazla bilgi için Client-Side Betiği ile çalışma konusuna bakın.

Özet

Bazı ASP.NET sunucu denetimleri, alt denetimlerinin işlenen öznitelik değerlerini ve yöntemi tarafından FindControl tuvallenen id denetimlerin kapsamını etkileyen adlandırma kapsayıcıları görevi görür. Ana sayfalarla ilgili olarak, hem ana sayfanın kendisi hem de ContentPlaceHolder denetimleri kapsayıcıları adlandırır. Sonuç olarak, kullanarak FindControliçerik sayfasındaki denetimlere program aracılığıyla başvurmak için biraz daha fazla çalışma yapmamız gerekir. Bu öğreticide iki tekniği inceledik: ContentPlaceHolder denetiminde detaya gitme ve yöntemini çağırma FindControl ve tüm adlandırma kapsayıcılarında özyinelemeli olarak arama yapan kendi FindControl uygulamamızı döndürme.

Web denetimlerine başvurmayla ilgili olarak sunucu tarafı adlandırma kapsayıcılarının neden olduğu sunucu tarafı sorunlarına ek olarak, istemci tarafı sorunları da vardır. Kapsayıcıları adlandırma olmadığında, Web denetiminin ID özellik değeri ve işlenen id öznitelik değeri aynı olur. Ancak adlandırma kapsayıcısının eklenmesiyle, işlenen id öznitelik hem Web denetiminin değerlerini hem de ID denetim hiyerarşisinin atalarındaki adlandırma kapsayıcılarını içerir. İstemci tarafı betiğinizde işlenen id öznitelik değerini belirlemek için Web denetiminin ClientID özelliğini kullandığınız sürece bu adlandırma endişeleri sorun oluşturmaz.

Mutlu Programlama!

Daha Fazla Bilgi

Bu öğreticide ele alınan konular hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın:

• ana sayfaları ASP.NET ve FindControl
• Dinamik Veri Girişi Kullanıcı Arabirimleri Oluşturma
• Nasıl yapılır: Ana Sayfa İçeriği ASP.NET Başvuru
• Mater Sayfaları: İpuçları, Püf Noktaları ve Tuzaklar
• Client-Side Betiği ile Çalışma

Yazar hakkında

Birden çok ASP/ASP.NET kitabının yazarı ve 4GuysFromRolla.com kurucusu Scott Mitchell, 1998'den beri Microsoft Web teknolojileriyle çalışmaktadır. Scott bağımsız bir danışman, eğitmen ve yazar olarak çalışmaktadır. Son kitabı Sams Teach Yourself ASP.NET 3.5 in 24 Hours(24 Saatte 3.5) kitabıdır. Scott'a adresinden mitchell@4GuysFromRolla.com veya adresinden blogundan http://ScottOnWriting.NETulaşabilirsiniz.

Özel Teşekkürler

Bu öğretici serisi birçok yararlı gözden geçiren tarafından gözden geçirildi. Bu öğreticinin baş gözden geçirenleri Zack Jones ve Suchi Barnerjee'ydi. Yaklaşan MSDN makalelerimi gözden geçirmek istiyor musunuz? Öyleyse, bana adresinden bir satır mitchell@4GuysFromRolla.combırakın.

ÖncekiSonraki