PageAdapter Kelas

Definisi

Ruang nama:

System.Web.UI.Adapters

Rakitan:

System.Web.dll

Mengadaptasi halaman Web untuk browser tertentu dan menyediakan kelas dasar tempat semua adaptor halaman mewarisi, secara langsung atau tidak langsung.

public ref class PageAdapter abstract : System::Web::UI::Adapters::ControlAdapter

public abstract class PageAdapter : System.Web.UI.Adapters.ControlAdapter

type PageAdapter = class
    inherit ControlAdapter

Public MustInherit Class PageAdapter
Inherits ControlAdapter

Warisan

Object

ControlAdapter

PageAdapter

Contoh

Contoh kode berikut menunjukkan cara mendapatkan kelas bernama CustomPageAdapter dari PageAdapter kelas dan mengambil alih RenderBeginHyperlink metode . Metode menambahkan RenderBeginHyperlink atribut bernama src ke hyperlink, yang berisi referensi ke halaman saat ini. Semua hyperlink yang dirender di halaman yang CustomPageAdapter dilampirkan akan memiliki src atribut .

using System;
using System.IO;
using System.Web;
using System.Web.UI;
using System.Web.UI.Adapters;

// A derived PageAdapter class.
public class CustomPageAdapter : PageAdapter
{
    // Override RenderBeginHyperlink to add an attribute that 
    // references the referring page.
    public override void RenderBeginHyperlink(
        HtmlTextWriter writer, string targetUrl,
        bool encodeUrl, string softkeyLabel, 
        string accessKey )
    {
        string url = null;

        // Add the src attribute, if referring page URL is available.
        if( Page != null && Page.Request != null &&
            Page.Request.Url != null )
        {
            url = Page.Request.Url.AbsoluteUri;
            if( encodeUrl )
                url = HttpUtility.HtmlAttributeEncode( url );
            writer.AddAttribute( "src", url );
        }

        // Add the accessKey attribute, if caller requested.
        if( accessKey != null && accessKey.Length == 1 )
            writer.AddAttribute( "accessKey", accessKey );

        // Add the href attribute, encode the URL if requested.
        if( encodeUrl )
            url = HttpUtility.HtmlAttributeEncode( targetUrl );
        else
            url = targetUrl;
        writer.AddAttribute( "href", url );

        // Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag( "a" );
    }
}

Imports System.IO
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.Adapters

' A derived PageAdapter class.
Public Class CustomPageAdapter
    Inherits PageAdapter

    ' Override RenderBeginHyperlink to add an attribute that 
    ' references the referring page.
    Public Overrides Sub RenderBeginHyperlink( _
        ByVal writer As HtmlTextWriter, ByVal targetUrl As String, _
        ByVal encodeUrl As Boolean, ByVal softkeyLabel As String, _
        ByVal accessKey As String)

        Dim url As String

        ' Add the src attribute, if referring page URL is available.
        If Not (Page Is Nothing) Then
            If Not (Page.Request Is Nothing) Then
                If Not (Page.Request.Url Is Nothing) Then

                    url = Page.Request.Url.AbsoluteUri
                    If encodeUrl Then
                        url = HttpUtility.HtmlAttributeEncode(url)
                    End If
                    writer.AddAttribute("src", url)
                End If
            End If
        End If

        ' Render the accessKey attribute, if requested.
        If Not (accessKey Is Nothing) Then
            If accessKey.Length = 1 Then
                writer.AddAttribute("accessKey", accessKey)
            End If
        End If

        ' Add the href attribute, encode the URL if requested.
        If (encodeUrl) Then
            url = HttpUtility.HtmlAttributeEncode(targetUrl)
        Else
            url = targetUrl
        End If
        writer.AddAttribute("href", url)

        ' Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag("a")

    End Sub
End Class

Keterangan

Kelas PageAdapter adalah kelas abstrak yang mengadaptasi halaman Web untuk kelas browser tertentu, yang ditentukan oleh bahasa markup yang digunakan browser (misalnya, HTML atau XHTML). Sebagian besar kemampuan beradaptasi dalam perilaku penyajian dapat dienkapsulasi dalam kelas penulis teks khusus yang berasal dari HtmlTextWriter kelas , sehingga tidak selalu perlu menyediakan adaptor halaman.

Sebagian besar anggota adaptor halaman turunan dipanggil dari Page kelas atau dari adaptor kontrol. Pertama, Page adaptor kelas atau kontrol mendeteksi keberadaan adaptor halaman turunan, lalu memanggil anggota, atau menyediakan fungsionalitas jika adaptor halaman tidak ada.

PageAdapter Anggota kelas menyediakan fungsionalitas berikut:

• Properti CacheVaryByHeaders dan CacheVaryByParams menentukan header HTTP tambahan dan HTTP GET dan POST parameter yang dapat digunakan untuk berbagai penembolokan. Mereka dipanggil selama inisialisasi cache dari Page kelas .

• Metode GetStatePersister mengembalikan objek yang dapat digunakan untuk mempertahankan tampilan gabungan dan status kontrol halaman. Ini dirujuk dari PageStatePersister properti jika adaptor halaman turunan ada.

• Metode ini GetPostBackFormReference menyediakan fragmen kode DHTML yang dapat digunakan untuk mereferensikan formulir dalam skrip.

• Metode mengembalikan DeterminePostBackMode kumpulan variabel postback jika halaman berada di postback. Ini dipanggil oleh .NET Framework alih-alih Page.DeterminePostBackMode metode jika adaptor halaman turunan ada.

• Metode RenderBeginHyperlink dan RenderEndHyperlink digunakan oleh adaptor kontrol untuk merender hyperlink jika adaptor halaman turunan ada.

• Metode ini RenderPostBackEvent merender tag klien hyperlink atau postback yang dapat mengirimkan formulir.

• Metode RegisterRadioButton dan GetRadioButtonsByGroup digunakan oleh adaptor kontrol tombol radio untuk mereferensikan kontrol lain RadioButton dalam grup tombol radio.

• Properti ClientState menyediakan akses ke kontrol gabungan dan melihat status Page objek melalui properti Page internal ClientState kelas.

• Metode TransformText ini digunakan oleh adaptor kontrol untuk melakukan transformasi teks khusus perangkat.

Konstruktor

Nama	Deskripsi
PageAdapter()	Menginisialisasi instans baru dari kelas PageAdapter.

Properti

Nama	Deskripsi
Browser	Mendapatkan referensi ke kemampuan browser klien yang membuat permintaan HTTP saat ini. (Diperoleh dari ControlAdapter)
CacheVaryByHeaders	Mendapatkan daftar header HTTP tambahan di mana penembolokan bervariasi untuk halaman Web tempat adaptor halaman turunan ini dilampirkan.
CacheVaryByParams	Mendapatkan daftar parameter tambahan dari permintaan HTTP GET dan POST tempat penembolokan bervariasi untuk halaman Web tempat adaptor halaman turunan ini dilampirkan.
ClientState	Mendapatkan string yang dikodekan yang berisi data status tampilan dan kontrol halaman Web tempat adaptor halaman turunan ini dilampirkan.
Control	Mendapatkan referensi ke kontrol tempat adaptor kontrol ini dilampirkan. (Diperoleh dari ControlAdapter)
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

Nama	Deskripsi
BeginRender(HtmlTextWriter)	Dipanggil sebelum penyajian kontrol. Dalam 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)
DeterminePostBackMode()	Menentukan apakah halaman Web berada di postback dan mengembalikan kumpulan nama/nilai variabel postback.
DeterminePostBackModeUnvalidated()	Mengembalikan kumpulan nilai nama data yang diposting ke halaman menggunakan perintah POST atau GET, tanpa melakukan validasi permintaan ASP.NET pada permintaan.
EndRender(HtmlTextWriter)	Dipanggil setelah penyajian kontrol. Dalam 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)
GetPostBackFormReference(String)	Mengembalikan fragmen kode DHTML yang dapat digunakan browser klien untuk mereferensikan formulir pada halaman yang diposting.
GetRadioButtonsByGroup(String)	Mengambil kumpulan kontrol tombol radio yang ditentukan oleh groupName.
GetStatePersister()	Mengembalikan objek yang digunakan oleh halaman Web untuk mempertahankan status kontrol dan tampilan.
GetType()	Mendapatkan Type instans 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 oleh SaveAdapterViewState() selama permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (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)
RegisterRadioButton(RadioButton)	Menambahkan kontrol tombol radio ke koleksi untuk grup tombol radio tertentu.
Render(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol tempat adaptor kontrol dilampirkan. (Diperoleh dari ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Merender tag hyperlink pembuka yang menyertakan URL target dan kunci akses ke aliran respons.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Merender tag hyperlink pembuka yang menyertakan URL target ke aliran respons.
RenderChildren(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol anak dalam kontrol komposit tempat adaptor kontrol dilampirkan. (Diperoleh dari ControlAdapter)
RenderEndHyperlink(HtmlTextWriter)	Merender tag hyperlink penutup ke aliran respons.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Merender peristiwa postback ke dalam aliran respons sebagai hyperlink, termasuk status tampilan yang dikodekan, target peristiwa dan argumen, parameter halaman sebelumnya, dan kunci akses.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Merender peristiwa postback ke dalam aliran respons sebagai hyperlink, termasuk status tampilan yang dikodekan dan mungkin dienkripsi, target peristiwa dan argumen, parameter halaman sebelumnya, dan kunci akses.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String)	Merender peristiwa postback ke dalam aliran respons sebagai hyperlink, termasuk status tampilan yang dikodekan dan mungkin dienkripsi, serta target peristiwa dan argumen.
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)
TransformText(String)	Mengubah teks untuk browser target.

Lihat juga

• ControlAdapter