IExtenderControl Arabirim

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Bir genişletici denetiminin davranışını tanımlar.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Türetilmiş

System.Web.UI.ExtenderControl

Açıklamalar

Sınıfından türetilen genişletici denetimlerinin ExtenderControl ScriptManager sayfada bir denetim olması gerekir. ExtenderControlTemel sınıf, sayfada bir denetimin mevcut olduğundan emin olmak için açık bir test gerçekleştirir ScriptManager .

Ancak, genişletici denetimleri oluşturmak isterseniz ve sayfa bir ScriptManager denetim içermiyorsa, arabirimi doğrudan uygulayan bir sınıf oluşturabilirsiniz IExtenderControl . Ayrıca, öğesinden türetilen bir sınıf oluşturuyorsanız Control veya ' den türetilen var olan bir denetimi genişlettikten sonra Control , IExtenderControl istemci işlevselliğini desteklemek için arabirimini uygulayabilirsiniz.

IExtenderControlArabirim, yöntemini çağırarak bir denetim için komut dosyası kitaplıklarını kaydeder GetScriptReferences ve ScriptDescriptor yöntemini çağırarak nesneleri kaydeder GetScriptDescriptors . GetScriptDescriptorsYöntemi, nesnelerin bir IEnumerable listesini döndürür ScriptDescriptor .

Not

Sınıfından türetilmiş varolan bir denetim türünü genişletirseniz WebControl IScriptControl arabirimini uygulayın.

Uygulayarak bir genişletici denetimi oluşturmak için aşağıdakileri IExtenderControl yapın:

• OnInitSayfada varsa denetimi tespit etmek ve kullanmak için denetim olayının kodunu yazın ScriptManager .

• Sayfasında yoksa, ScriptManager sınıfının statik yöntemlerini çağırarak gerekli betikleri kaydettirmek için alternatif bir yol belirtin ScriptManager .

• Üyeler için korumalı sanal Üyeler sağlayın IExtenderControl .

• Örnek betiği, denetimle kaydoltiğiniz bir betik bloğu olarak sağlayın ScriptManager . Bunu PreRender , denetimin, PreRenderComplete veya olaylar sırasında yapmanız gerekir Render .

• Denetim olayı sırasında betik tanımlayıcılarını kaydedin Render .

Not

Sayfa bir UpdatePanel denetim içeriyorsa, sayfanın bir denetim içermesi gerekir ScriptManager . IExtenderControlArabirimi yalnızca sayfa bir denetim içermiyorsa uygulamanız gerekir ScriptManager .

Yöntemler

GetScriptDescriptors(Control)	ScriptDescriptorDenetim için nesneleri kaydeder ve denetimin nesnelerini içeren bir nesne döndürür ScriptDescriptor .
GetScriptReferences()	Denetim için komut dosyası kitaplıklarını kaydeder ve katıştırılmış kaynaklar olarak kaydedilmiş ECMAScript (JavaScript) dosyalarının bir listesini döndürür.

Ayrıca bkz.

• ExtenderControl
• ScriptManager