HideDisabledControlAdapter Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.Adapters

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan kapabilitas penyajian untuk kontrol Web terkait guna mengubah markup atau perilaku default untuk browser tertentu.

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

Warisan: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Contoh

Contoh kode berikut menunjukkan cara memperluas HideDisabledControlAdapter kelas untuk menampilkan Label kontrol dalam status diaktifkan dan dinonaktifkan. Contoh ini berisi tiga bagian:

Adaptor yang berasal dari HideDisabledControlAdapter kelas .
File .aspx yang menggabungkan Label kontrol dan konten khusus perangkat.
File browser untuk menautkan adaptor ke jenis perangkat.

Contoh kode berikut menunjukkan cara memperluas HideDisabledControlAdapter kelas.

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

Contoh kode berikut menunjukkan cara mendeklarasikan Label kontrol dengan konten khusus perangkat.

<%@ 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>

Contoh kode berikut menunjukkan cara menautkan Label kontrol ke adaptor kustom untuk browser yang berjalan di Windows CE .NET.

Keterangan

Kelas HideDisabledControlAdapter mengadaptasi WebControl kontrol terkait untuk memodifikasi markup atau perilaku default untuk browser tertentu. Anda dapat memperluas HideDisabledControlAdapter kelas untuk menyesuaikan penyajian WebControl kontrol lebih lanjut.

Adaptor dikompilasi komponen .NET Framework yang mengambil alih satu atau beberapa tahap dalam siklus hidup halaman atau kontrol. Memperluas HideDisabledControlAdapter kelas akan memberikan akses ke tahap WebControl siklus hidup kontrol. Untuk informasi selengkapnya, lihat Gambaran Umum Arsitektur Perilaku Kontrol Adaptif.

Permintaan awal untuk adaptor menyebabkan .NET Framework mencari adaptor yang dipetakan untuk kontrol mengingat karakteristik browser yang meminta. File definisi browser digunakan oleh HttpBrowserCapabilities kelas untuk mengidentifikasi karakteristik browser klien dan memetakan adaptor ke jenis browser. Untuk informasi selengkapnya, lihat Gambaran Umum Arsitektur Perilaku Kontrol Adaptif.

Konstruktor

HideDisabledControlAdapter()

Menginisialisasi instans baru kelas HideDisabledControlAdapter.

Properti

Browser	Mendapatkan referensi ke kemampuan browser klien yang membuat permintaan HTTP saat ini. (Diperoleh dari ControlAdapter)
Control	Mendapatkan referensi ke kontrol Web tempat adapter kontrol ini dilampirkan. (Diperoleh dari WebControlAdapter)
IsEnabled	Mendapatkan nilai yang menunjukkan apakah kontrol Web dan semua kontrol induknya diaktifkan. (Diperoleh dari WebControlAdapter)
Page	Mendapatkan referensi ke halaman tempat kontrol yang terkait dengan adaptor ini berada. (Diperoleh dari ControlAdapter)
PageAdapter	Mendapatkan referensi ke adaptor halaman untuk halaman tempat kontrol terkait berada. (Diperoleh dari ControlAdapter)

Metode

BeginRender(HtmlTextWriter)	Dipanggil sebelum penyajian kontrol. Di kelas adaptor turunan, menghasilkan tag pembuka yang diperlukan oleh target tertentu tetapi tidak diperlukan oleh browser HTML. (Diperoleh dari ControlAdapter)
CreateChildControls()	Membuat kontrol turunan khusus target untuk kontrol komposit. (Diperoleh dari ControlAdapter)
EndRender(HtmlTextWriter)	Dipanggil setelah penyajian kontrol. Di kelas adaptor turunan, menghasilkan tag penutup yang diperlukan oleh target tertentu tetapi tidak diperlukan oleh browser HTML. (Diperoleh dari ControlAdapter)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
LoadAdapterControlState(Object)	Memuat informasi status kontrol adaptor yang disimpan selama SaveAdapterControlState() permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
LoadAdapterViewState(Object)	Memuat informasi status tampilan adaptor yang disimpan selama SaveAdapterViewState() permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnInit(EventArgs)	Mengambil alih OnInit(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnLoad(EventArgs)	Mengambil alih OnLoad(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnPreRender(EventArgs)	Mengambil alih OnPreRender(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnUnload(EventArgs)	Mengambil alih OnUnload(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
Render(HtmlTextWriter)	Menulis kontrol Web terkait ke aliran output sebagai HTML.
RenderBeginTag(HtmlTextWriter)	Membuat tag awal untuk kontrol Web di markup yang dikirimkan ke browser target. (Diperoleh dari WebControlAdapter)
RenderChildren(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol anak dalam kontrol komposit tempat adaptor kontrol dilampirkan. (Diperoleh dari ControlAdapter)
RenderContents(HtmlTextWriter)	Menghasilkan markup dalam khusus target untuk kontrol Web tempat adaptor kontrol dilampirkan. (Diperoleh dari WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Membuat tag akhir untuk kontrol Web dalam markup yang dikirimkan ke browser target. (Diperoleh dari WebControlAdapter)
SaveAdapterControlState()	Menyimpan informasi status kontrol untuk adaptor kontrol. (Diperoleh dari ControlAdapter)
SaveAdapterViewState()	Menyimpan informasi status tampilan untuk adaptor kontrol. (Diperoleh dari ControlAdapter)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui