ControlAdapter Sınıf

Tanım

public ref class ControlAdapter abstract

public abstract class ControlAdapter

type ControlAdapter = class

Public MustInherit Class ControlAdapter

Devralma

Object

ControlAdapter

Türetilmiş

System.Web.UI.Adapters.PageAdapter

System.Web.UI.WebControls.Adapters.WebControlAdapter

Açıklamalar

Denetim bağdaştırıcıları, tarayıcıya veya işaretlemeye özgü işlemeye izin vermek için yürütme yaşam döngüsündeki belirli Control sınıf yöntemlerini ve olaylarını geçersiz kılan bileşenlerdir. .NET Framework, her istemci isteği için tek bir türetilmiş denetim bağdaştırıcısını bir Control nesneye eşler.

Bağdaştırıcı, belirli bir tarayıcı veya tarayıcı sınıfı için denetimi değiştirir veya bazı özelliklerde rastgele bir filtre işlevi görür. Bağdaştırıcı genellikle tarayıcının kullandığı işaretleme diliyle tanımlanır (örneğin, XHTML veya HTML 3.2). İşleme davranışındaki uyarlanabilirliğin çoğu, sınıfından türetilen HtmlTextWriter özel sınıflarda kapsüllenebilir. Bu nedenle, tek bir bağdaştırıcının bir dizi tarayıcı sınıfı davranışı için kullanılabilmesi veya uyarlanabilirliğin HtmlTextWriter sınıflara eklenmesi, denetim bağdaştırıcısının kullanılmasını gereksiz hale getirebilir.

Bir denetim sınıfı için bağdaştırıcı, daha özel bağdaştırıcılar olmadığı sürece bu sınıftan devralan tüm denetimler için geçerlidir. Örneğin, sınıfı için BaseValidator bir bağdaştırıcı tüm Validator nesneler için kullanılabilir.

Bağdaştırıcılar genellikle doğrudan sınıfından ControlAdapter değil, denetim türüne ve hedef tarayıcıya veya gerekli işlemeye özgü ek işlevler sağlayan hedefe özgü bağdaştırıcı temel sınıflarından birinden devralır.

Denetimlerin kendileri için mutlaka bir bağdaştırıcı gerekmez. Denetimler bileşim aracılığıyla genişletilirse, genellikle alt denetim bağdaştırıcıları yeterlidir.

Her denetimin .browser tanım dosyaları aracılığıyla bağdaştırıcılarla açık eşlemeleri vardır. Bu nedenle, özelliğine Control.Adapter herhangi bir erişim, tarayıcı tanım dosyalarından ayıklanan nesneyi kullanarak HttpBrowserCapabilities bağdaştırıcının denetlenecek eşlemesi için arama gerçekleştirir.

İşleme sırasında, .NET Framework hedefe özgü olabilecek bir denetimin geçersiz kılınabilir yöntemlerine çağrılar durdurur. Bir denetim bağdaştırıcısı takılıysa, .NET Framework ilişkili bağdaştırıcı yöntemlerini çağırır.

Bağdaştırıcı, yöntemi aracılığıyla Render denetim için işleme gerçekleştirir. Geçersiz kılınırsa, Render yönteminde geri Control.Render çağrı gerçekleştirdiği için temel sınıf uygulamasını çağırmama olasılığı vardır. Bu, işlemenin bir kez bağdaştırıcı ve bir kez denetim tarafından olmak üzere iki kez gerçekleşmesine neden olabilir.

Render Temel yöntem, denetimin Control.Render yöntemini geri çağırır. Bu nedenle, geçersiz kılarsanız Render, uyguladığınız işleme denetimi tarafından Control.Render sağlanan işlemeye ek olmadığı sürece temel sınıf uygulamasını çağırmamalısınız.

.NET Framework alt denetimlerin bağdaştırıcıları için kesme işlemi gerçekleştirdiğinden emin olmanız gerekir. Bunu, denetimin RenderChildren yöntemini geçersiz kılmanızdan Render çağıran temel yöntemi çağırarak Control.RenderChildren yapabilirsiniz.

BeginRender ve EndRender yöntemleri, denetimin yöntemini çağırdığı hemen önce ve sonra (sırasıyla) denetim tarafından çağrılırRender. Ön ve son işleme gereken tek tarayıcıya özgü işleme görevleriyse, kullanarak BeginRender ve EndRender kullanarak geçersiz kılmayı Rendergereksiz hale getirebilirsiniz. ve yöntemlerinin BeginRender varsayılan davranışı, karşılık gelen yöntemlerini çağırmaktırHtmlTextWriter.EndRender

Bir denetim bağdaştırıcısı, kendi durum bilgilerini korumak için , LoadAdapterControlState, SaveAdapterViewStateve LoadAdapterViewState yöntemlerini geçersiz kılabilirSaveAdapterControlState. SaveAdapterControlState, SaveAdapterViewState, LoadAdapterControlStateve LoadAdapterViewState özel denetim ve görünüm durumları sırasıyla kaydedildiğinde ve yüklendiğinde çağrılır.

OnInit, OnLoad, OnPreRenderve OnUnload temel yöntemleri karşılık gelen Control sınıf yöntemlerini geri çağırır. Bu nedenle, geçersiz kılınan bu ControlAdapter yöntemlerden herhangi birinin temel yöntemlerini çağırması gerekir; aksi takdirde, sınıf yöntemiyle Control ilişkili olay tetiklenmez.

Denetimler ve bağdaştırıcılar isteğe bağlı olarak ve IPostBackEventHandler arabirimlerini uygularIPostBackDataHandler. .NET Framework, bir bağdaştırıcının var olup olmadığını ve bağdaştırıcının bu arabirimleri uygulayıp uygulamadığını belirler. Varsa, bağdaştırıcının , ve RaisePostBackEvent yöntemlerini gerektiği gibi geçersiz kılması LoadPostDataRaisePostDataChangedEventgerekir. Geri gönderme verileri bağdaştırıcıda tanınmıyorsa, işlemek için denetimi yeniden çağırması gerekir. Sonraki olay işleyicileri de denetimde geri çağırmalıdır.

Uygulayanlara Notlar

sınıfından ControlAdapter devraldığınızda, genel bağdaştırıcı işlevselliği gerektiren bir denetimin, desende ControlTypeAdapter adlı karşılık gelen bir bağdaştırıcı temel sınıfı olmalıdır (örneğin, TextBoxAdapter). Bağdaştırıcı, özelliği aracılığıyla Control denetimin kesin olarak belirlenmiş bir örneğini en azından döndürmelidir.

1. Belirli bir denetim türü ve işaretleme dili için denetim bağdaştırıcıları desende MarkupControlTypeAdapter (örneğin, XhtmlTextBoxAdapter) adlandırılmalıdır. Bir denetimin bağdaştırıcıları bir Adapters alt ad alanına uygulanmalıdır.

Denetim bağdaştırıcıları uygun temel sınıftan devralmalı ve denetimle aynı devralma modelini izlemelidir. Örneğin, temel sınıftan devralan bir denetimin Control bağdaştırıcısı, sınıfından ControlAdapter veya ilgili ControlTypeAdapter sınıftan devralmalıdır.

Tüm özelleştirilmiş bağdaştırıcılar, yapılandırma .browser dosyalarındaki tüm cihaz düğümleri altında özel denetim için tanımlanmalıdır.

Düzgün uygulanan bir denetim, bir bağdaştırıcının bağlı olduğunu veya bağlı bağdaştırıcının belirli bir arabirim uyguladığını varsaymamalıdır. Bunun yerine, aramadan önce bunları denetlemesi gerekir.

denetiminde, yöntemi LinkButtongibi korumalı olay yöntemlerini geçersiz kılma benzetimi OnClick(EventArgs) yapmak mümkündür. İlk olarak, OnClick yöntemiyle bir bağdaştırıcı sınıfı oluşturun. Ardından yönteminden LinkButton türetilmiş yeni bir denetim oluşturun ve yöntemini geçersiz kılın OnClick(EventArgs) . Geçersiz kılınan OnClick(EventArgs) yöntem, bağdaştırıcının OnClick yöntemini çağırır. Bağdaştırıcı nesnesi, sınıfının korumalı Adapter özelliği Control aracılığıyla kullanılabilir. Adapter Denetimin özelliği, ilişkili bağdaştırıcı bulunmadığındadırnull, bu nedenle bağdaştırıcının yöntemlerini çağırmadan önce herhangi bir kodun bu koşulu denetlemesi gerekir.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• Control