Control.RenderingCompatibility Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

public:
 virtual property Version ^ RenderingCompatibility { Version ^ get(); void set(Version ^ value); };

[System.ComponentModel.Bindable(false)]
[System.ComponentModel.Browsable(false)]
public virtual Version RenderingCompatibility { get; set; }

[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.RenderingCompatibility : Version with get, set

Public Overridable Property RenderingCompatibility As Version

Özellik Değeri

Version

HTML'yi işleyen ASP.NET sürümü ile uyumlu olacaktır.

Öznitelikler: BindableAttribute BrowsableAttribute

Açıklamalar

ASP.NET bu özelliği Web.config dosyasındaki öğesinin pages özniteliğinin değerine controlRenderingCompatibilityVersion ayarlar. controlRenderingCompatibilityVersion öznitelik Web.config dosyasında ayarlanmadıysa, varsayılan değer ASP.NET geçerli sürümüdür.

Dikkat

Bu özellik için bir genel küme erişimcisi vardır, ancak küme erişimcisi .NET Framework altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır. Kodunuzda bu değeri ayarlarsanız etkisi tahmin edilemez.

her ASP.NET sürümü HTML'i önceki sürümlerden farklı işlenebilir. Örneğin, ASP.NET 3.5'te, bir Label denetimin özelliği varsayılan olarak ise IsEnabledfalse, ASP.NET özniteliği "devre dışı" olarak ayarlanmış bir span öğeyi disabled işler. ASP.NET 4'te, span öğe varsayılan olarak özniteliği yerine disabled basamaklı stil sayfası (CSS) class özniteliğiyle işlenir. Bu, denetimin devre dışı görünümünü belirtmenize olanak tanır ve geçersiz HTML'nin işlenmesini önler. (HTML 4.0 ve XHTML 1.1'de span öğesi özniteliğini disabled desteklemez.)

Web uygulaması, HTML işleme değiştiğinde düzgün çalışmayan kod içerebilir. Bu sorunu önlemek için, Web.config dosyasındaki öğesinin pages özniteliğini, uyumluluğu korumak istediğiniz önceki sürümü gösterecek şekilde ayarlayabilirsinizcontrolRenderingCompatibilityVersion. Örneğin, özelliğini olarak ayarlarsanızRenderingCompatibility, devre dışı bırakılmış Label bir denetim CSS sınıfını değil özniteliğini işlerdisabled.3.5

Not

Bu özelliği ayarlayabileceğiniz en eski sürüm şeklindedir 3.5.

Geriye dönük uyumluluğu korumak için, Bir Web projesini önceki bir sürümden ASP.NET 4'e yükseltmek için Visual Studio kullandığınızda, Visual Studio Web.config dosyasındaki özniteliğini otomatik olarak olarak 3.5olarak ayarlarcontrolRenderingCompatibilityVersion. Yükseltilmiş bir Web sitesinin, ASP.NET 4'te tanıtılan algoritmayı kullanarak HTML'yi işlemesini controlRenderingCompatibilityVersion istiyorsanız, özniteliğini değiştirebilir veya kaldırabilirsiniz.

Çoğu zaman, bu özellik tarafından denetlenen davranış otomatiktir ve kodunuzda özelliği denetlemeniz RenderingCompatibility gerekmez. Ancak, özel bir denetimi programlamak istiyorsanız, bu özelliğin ayarına göre denetimin davranışını değiştiren kod eklemeniz gerekebilir. Örneğin, ASP.NET 4 için özel bir denetim denetimlerden Label oluşturulmuş olabilir ve özel denetim, sınıfı değiştiren aspNetDisabled JavaScript kodu oluşturarak denetimin devre dışı görünümünü belirtebilir. Bu, veya sonraki bir sürümde RenderingCompatibility4.0 beklendiği gibi çalışır. Ancak, olduğunda RenderingCompatibility3.5da aynı etkiyi elde etmek için özel denetimin kodu, özelliği falseolduğunda IsEnabled denetimin CssClass özelliğini "aspNetDisabled" olarak ayarlamalıdır.

Şunlara uygulanır

Ayrıca bkz.

ControlRenderingCompatibilityVersion