HideDisabledControlAdapter Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.Adapters

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.

Belirli bir tarayıcının varsayılan işaretlemesini veya davranışını değiştirmek için ilişkili Web denetimi için işleme özellikleri sağlar.

public ref class HideDisabledControlAdapter : System::Web::UI::WebControls::Adapters::WebControlAdapter

public class HideDisabledControlAdapter : System.Web.UI.WebControls.Adapters.WebControlAdapter

type HideDisabledControlAdapter = class
    inherit WebControlAdapter

Public Class HideDisabledControlAdapter
Inherits WebControlAdapter

Devralma: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Örnekler

Aşağıdaki kod örneği, etkin ve devre dışı durumdaki bir Label denetimi görüntülemek için sınıfın HideDisabledControlAdapter nasıl genişletildiğini gösterir. Bu örnek üç bölümden oluşur:

sınıfından HideDisabledControlAdapter türetilmiş bir bağdaştırıcı.
Denetimi ve cihaza özgü içeriği içeren Label .aspx dosyası.
Bağdaştırıcıyı bir cihaz türüne bağlamak için bir tarayıcı dosyası.

Aşağıdaki kod örneği, sınıfın nasıl genişlet yapılacağını HideDisabledControlAdapter gösterir.

using System;
using System.Web;
using System.Web.UI;
using System.Security.Permissions;

namespace Contoso
{
    [AspNetHostingPermission(
        SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(
        SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    public class HideDisabledControlContosoAdapter:
        System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter
    {
        // Link the Label control to the adapter.
        protected new System.Web.UI.WebControls.Label Control
        {
            get
            {
                return (System.Web.UI.WebControls.Label)base.Control;
            }
        }

        // Do not render the Contoso controls if Enabled is false.
        protected override void Render(System.Web.UI.HtmlTextWriter writer)
        {
            if (Control.ID.StartsWith("Contoso"))
            {
                if (!Control.Enabled)
                {
                    return;
                }
            }

            base.Render(writer);
        }
    }
}

Imports System.Web
Imports System.Web.UI
Imports System.Security.Permissions

Namespace Contoso
    <AspNetHostingPermission( _
        SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission( _
        SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class HideDisabledControlContosoAdapter
        Inherits System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter
    
        Protected Overloads ReadOnly Property Control() As _
            System.Web.UI.WebControls.Label
            Get
                Return CType( _
                    MyBase.Control, _
                    System.Web.UI.WebControls.Label)
            End Get
        End Property

        ' Do not render the control if Enabled is false.
        Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
            If (Control.ID.StartsWith("Contoso")) Then
                If (Not Control.Enabled) Then
                    Return
                End If
            End If

            MyBase.Render(writer)
        End Sub
    End Class
End Namespace

Aşağıdaki kod örneği, cihaza özgü içerikle nasıl denetim Label bildireceklerini gösterir.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HideDisabledControl Adapter</title>
    <script runat="server">
        void ServerButtonClick(Object source, EventArgs args)
        {
            if (Button1.Text == "Enable Label")
            {
                ContosoLabel1.Enabled = true;
                Button1.Text = "Disable Label";
                messageLabel.Text = "The label is <b>En</b>abled";
            }
            else
            {
                ContosoLabel1.Enabled = false;
                Button1.Text = "Enable Label";
                messageLabel.Text = "The label is <b>dis</b>abled";
            }
        }
    </script>
</head>
<body style="background-color:silver">
    <form id="Form1" runat="server">
        <asp:Label id="ContosoLabel1"             
            text="Contoso Label" 
            WinCE:text="CE Label"
            BorderWidth="3" 
            BorderStyle="Inset"
            style="FONT-SIZE: xx-small"
            runat="server">
            </asp:Label>
        <br />
        <asp:Button id="Button1" 
            text="Disable Label"
            OnClick="ServerButtonClick" 
            runat="server" />
        <br />    
        <asp:Label id="messageLabel" 
            runat="server" 
            style="FONT-SIZE: xx-small"
            AssociatedControlID="Button1">
            <i>Select the button to disable the label.</i>
        </asp:Label>
    </form>
</body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HideDisabledControl Adapter</title>
    <script runat="server">
        Sub ServerButtonClick(ByVal source As Object, ByVal args As EventArgs)
            If (Button1.Text.Equals("Enable Label")) Then
                ContosoLabel1.Enabled = True
                Button1.Text = "Disable Label"
                messageLabel.Text = "The label is <b>En</b>abled"
            Else
                ContosoLabel1.Enabled = False
                Button1.Text = "Enable Label"
                messageLabel.Text = "The label is <b>dis</b>abled"
            End If
        End Sub
    </script>
</head>
<body style="background-color:silver">
    <form id="Form1" runat="server">
        <asp:Label id="ContosoLabel1"             
            text="Contoso Label" 
            WinCE:text="CE Label"
            BorderWidth="3" 
            BorderStyle="Inset"
            style="FONT-SIZE: xx-small"
            runat="server">
            </asp:Label>
        <br />
        <asp:Button id="Button1" 
            text="Disable Label"
            OnClick="ServerButtonClick" 
            runat="server" />
        <br />    
        <asp:Label id="messageLabel" 
            runat="server" 
            style="FONT-SIZE: xx-small"
            AssociatedControlID="Button1">
            <i>Select the button to disable the label.</i>
        </asp:Label>
    </form>
</body>
</html>

Aşağıdaki kod örneği, denetimin Label Windows CE .NET üzerinde çalışan tarayıcılar için özel bağdaştırıcıya nasıl bağlandığını gösterir.

Açıklamalar

sınıfı, HideDisabledControlAdapter belirli bir tarayıcının varsayılan işaretlemesini veya davranışını değiştirmek için ilişkili WebControl denetimi uyarlar. Denetimin işlenmesini HideDisabledControlAdapter daha da özelleştirmek için sınıfını WebControl genişletebilirsiniz.

Bağdaştırıcılar, bir sayfanın veya denetimin yaşam döngüsünde bir veya daha fazla aşamayı devralan bileşenler .NET Framework derlenir. Sınıfın HideDisabledControlAdapter genişletilmesi, denetimin yaşam döngüsü aşamalarına WebControl erişim sağlar. Daha fazla bilgi için bkz. Uyarlamalı Denetim Davranışına Mimari Genel Bakış.

Bir bağdaştırıcının ilk isteği, .NET Framework istekte bulunan tarayıcının özelliklerine göre denetim için eşlenmiş bir bağdaştırıcıyı aramasına neden olur. Tarayıcı tanım dosyaları, istemci tarayıcısının HttpBrowserCapabilities özelliklerini tanımlamak ve bağdaştırıcıyı tarayıcı türüne eşlemek için sınıfı tarafından kullanılır. Daha fazla bilgi için bkz. Uyarlamalı Denetim Davranışına Mimari Genel Bakış.

Oluşturucular

HideDisabledControlAdapter()

HideDisabledControlAdapter sınıfının yeni bir örneğini başlatır.

Özellikler

Browser	Geçerli HTTP isteğini yapan istemcinin tarayıcı özelliklerine bir başvuru alır. (Devralındığı yer: ControlAdapter)
Control	Bu denetim bağdaştırıcısının bağlı olduğu Web denetimine başvuru alır. (Devralındığı yer: WebControlAdapter)
IsEnabled	Web denetiminin ve tüm üst denetimlerinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: WebControlAdapter)
Page	Bu bağdaştırıcıyla ilişkili denetimin bulunduğu sayfaya başvuru alır. (Devralındığı yer: ControlAdapter)
PageAdapter	İlişkili denetimin bulunduğu sayfanın sayfa bağdaştırıcısına başvuru alır. (Devralındığı yer: ControlAdapter)

Yöntemler

BeginRender(HtmlTextWriter)	Denetimin işlenmesinden önce çağrılır. Türetilmiş bir bağdaştırıcı sınıfında, belirli bir hedef için gerekli olan ancak HTML tarayıcıları için gerekli olmayan açma etiketleri oluşturur. (Devralındığı yer: ControlAdapter)
CreateChildControls()	Bileşik denetim için hedefe özgü alt denetimleri oluşturur. (Devralındığı yer: ControlAdapter)
EndRender(HtmlTextWriter)	Denetimin işlenmesinden sonra çağrılır. Türetilmiş bir bağdaştırıcı sınıfında, belirli bir hedef için gerekli olan ancak HTML tarayıcıları için gerekli olmayan kapanış etiketleri oluşturur. (Devralındığı yer: ControlAdapter)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadAdapterControlState(Object)	Önceki bir istek sırasında tarafından SaveAdapterControlState() bu denetim bağdaştırıcısıyla ilişkili denetimin bulunduğu sayfaya kaydedilen bağdaştırıcı denetim durumu bilgilerini yükler. (Devralındığı yer: ControlAdapter)
LoadAdapterViewState(Object)	Bu denetim bağdaştırıcısıyla ilişkili denetimin bulunduğu sayfaya önceki bir istek sırasında tarafından SaveAdapterViewState() kaydedilen bağdaştırıcı görünüm durumu bilgilerini yükler. (Devralındığı yer: ControlAdapter)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnInit(EventArgs)	OnInit(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
OnLoad(EventArgs)	OnLoad(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
OnPreRender(EventArgs)	OnPreRender(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
OnUnload(EventArgs)	OnUnload(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
Render(HtmlTextWriter)	İlişkili Web denetimini çıkış akışına HTML olarak yazar.
RenderBeginTag(HtmlTextWriter)	Hedef tarayıcıya iletilen işaretlemede Web denetimi için başlangıç etiketini oluşturur. (Devralındığı yer: WebControlAdapter)
RenderChildren(HtmlTextWriter)	Denetim bağdaştırıcısının bağlı olduğu bileşik denetimde alt denetimler için hedefe özgü işaretlemeyi oluşturur. (Devralındığı yer: ControlAdapter)
RenderContents(HtmlTextWriter)	Denetim bağdaştırıcısının bağlı olduğu Web denetimi için hedefe özgü iç işaretlemeyi oluşturur. (Devralındığı yer: WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Hedef tarayıcıya iletilen işaretlemede Web denetimi için bitiş etiketini oluşturur. (Devralındığı yer: WebControlAdapter)
SaveAdapterControlState()	Denetim bağdaştırıcısı için denetim durumu bilgilerini kaydeder. (Devralındığı yer: ControlAdapter)
SaveAdapterViewState()	Denetim bağdaştırıcısı için görünüm durumu bilgilerini kaydeder. (Devralındığı yer: ControlAdapter)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır