Control.RenderingCompatibility Özellik
Tanım
Ö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, setPublic Overridable Property RenderingCompatibility As VersionÖzellik Değeri
HTML işlenen ASP.NET sürümü ile uyumlu olacaktır.
- Öznitelikler
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, öğe varsayılan olarak span ö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şirse 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ı değil özniteliği işlerdisabled.3.5
Uyarı
Bu özelliği ayarlayabileceğiniz en eski sürüm: 3.5.
Geriye dönük uyumluluğu korumak için, Visual Studio kullanarak bir Web projesini önceki bir sürümden ASP.NET 4'e yükselttiğinizde, Visual Studio Web.config dosyasındaki özniteliğini otomatik olarak olarak olarak 3.5ayarlarcontrolRenderingCompatibilityVersion. Yükseltilmiş bir Web sitesinin ASP.NET 4'te tanıtılan algoritmayı kullanarak HTML'yi işlemesini istiyorsanız özniteliğini controlRenderingCompatibilityVersion 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 denetim programlıyorsanız, denetimin davranışını bu özelliğin ayarına göre değiştiren bir kod eklemeniz gerekebilir. Örneğin, ASP.NET 4 için özel bir denetim denetimlerden Label oluşabilir 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.5aynı etkiyi elde etmek için özel denetimin kodu, özelliği olduğunda IsEnabledfalsedenetimin CssClass özelliğini "aspNetDisabled" olarak ayarlamalıdır.
