PageAdapter Sınıf

Tanım

Ad Alanı:

System.Web.UI.Adapters

Bütünleştirilmiş Kod:

System.Web.dll

Bir Web sayfasını belirli bir tarayıcı için uyarlar ve tüm sayfa bağdaştırıcılarının doğrudan veya dolaylı olarak devraldığı temel sınıfı sağlar.

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

Devralma

Object

ControlAdapter

PageAdapter

Örnekler

Aşağıdaki kod örneğinde sınıfından PageAdapter adlı CustomPageAdapter bir sınıfın nasıl türetilip yönteminin nasıl geçersiz kılınması gösterilmektedirRenderBeginHyperlink. RenderBeginHyperlink yöntemi, geçerli sayfaya başvuru içeren köprüye adlı src bir öznitelik ekler. Ekli sayfalarda CustomPageAdapter işlenen tüm köprüler özniteliğine src sahip olur.

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

Açıklamalar

PageAdapter sınıfı, web sayfasını tarayıcının kullandığı işaretleme dili (örneğin, HTML veya XHTML) tarafından tanımlanan belirli bir tarayıcı sınıfı için uyarlayan soyut bir sınıftır. İşleme davranışındaki uyarlanabilirliğin çoğu, sınıfından türetilen HtmlTextWriter özelleştirilmiş metin yazıcı sınıflarında kapsüllenebilir, bu nedenle her zaman bir sayfa bağdaştırıcısı sağlamak gerekli değildir.

Türetilmiş sayfa bağdaştırıcılarının üyelerinin çoğu sınıfından Page veya denetim bağdaştırıcılarından çağrılır. İlk olarak, Page sınıf veya denetim bağdaştırıcıları türetilmiş sayfa bağdaştırıcısının varlığını algılar ve sonra üyeyi çağırır veya sayfa bağdaştırıcısı yoksa işlevselliği sağlar.

Sınıfın PageAdapter üyeleri aşağıdaki işlevleri sağlar:

• CacheVaryByHeaders ve CacheVaryByParams özellikleri, önbelleğe almayı değiştirmek için kullanılabilecek ek HTTP üst bilgileri ile HTTP GET ve POST parametreleri tanımlar. Sınıftan önbellek başlatma sırasında çağrılır Page .

• yöntemi, GetStatePersister sayfanın birleşik görünümünü ve denetim durumlarını kalıcı hale getirmek için kullanılabilecek bir nesne döndürür. Türetilmiş bir sayfa bağdaştırıcısı varsa özelliğinden PageStatePersister başvurulur.

• yöntemi, GetPostBackFormReference betiklerdeki formlara başvurmak için kullanılabilecek bir DHTML kod parçası sağlar.

• yöntemi, DeterminePostBackMode sayfa geri göndermedeyse geri gönderme değişkenlerinin bir koleksiyonunu döndürür. Türetilmiş bir sayfa bağdaştırıcısı varsa yöntemi yerine Page.DeterminePostBackMode .NET Framework tarafından çağrılır.

• RenderBeginHyperlink ve RenderEndHyperlink yöntemleri, türetilmiş bir sayfa bağdaştırıcısı varsa köprüleri işlemek için denetim bağdaştırıcıları tarafından kullanılır.

• yöntemi, RenderPostBackEvent formu gönderebilen bir köprü veya geri gönderme istemci etiketi oluşturur.

• RegisterRadioButton ve GetRadioButtonsByGroup yöntemleri radyo düğmesi denetim bağdaştırıcıları tarafından bir radyo düğmesi grubundaki diğer RadioButton denetimlere başvurmak için kullanılır.

• özelliği, ClientState sınıfının iç ClientState özelliği aracılığıyla birleştirilmiş denetime ve nesnenin Page görünüm durumlarına Page erişim sağlar.

• TransformText yöntemi, cihaza özgü metin dönüştürme gerçekleştirmek için denetim bağdaştırıcıları tarafından kullanılır.

Oluşturucular

PageAdapter()

PageAdapter 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)
CacheVaryByHeaders	Bu türetilmiş sayfa bağdaştırıcısının eklendiği Web sayfası için önbelleğe almanın çeşitli olduğu ek HTTP üst bilgilerinin listesini alır.
CacheVaryByParams	Bu türetilmiş sayfa bağdaştırıcısının eklendiği Web sayfası için önbelleğe alma özelliğinin çeşitli olduğu HTTP GET ve POST isteklerinden ek parametrelerin listesini alır.
ClientState	Bu türetilmiş sayfa bağdaştırıcısının eklendiği Web sayfasının görünüm ve denetim durum verilerini içeren kodlanmış bir dize alır.
Control	Bu denetim bağdaştırıcısının bağlı olduğu denetime başvuru alır. (Devralındığı yer: ControlAdapter)
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)
DeterminePostBackMode()	Web sayfasının geri göndermede olup olmadığını belirler ve geri gönderme değişkenlerinin ad/değer koleksiyonunu döndürür.
DeterminePostBackModeUnvalidated()	İstekte ASP.NET istek doğrulaması gerçekleştirmeden POST veya GET komutu kullanılarak sayfaya gönderilen verilerin ad-değer koleksiyonunu döndürür.
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)
GetPostBackFormReference(String)	İstemci tarayıcısının gönderilen sayfadaki forma başvurmak için kullanabileceği bir DHTML kod parçası döndürür.
GetRadioButtonsByGroup(String)	tarafından groupNamebelirtilen radyo düğmesi denetimlerinden oluşan bir koleksiyonu alır.
GetStatePersister()	Denetim ve görünüm durumlarını korumak için Web sayfası tarafından kullanılan bir nesne döndürür.
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)
RegisterRadioButton(RadioButton)	Belirtilen radyo düğmesi grubu için koleksiyona bir radyo düğmesi denetimi ekler.
Render(HtmlTextWriter)	Denetim bağdaştırıcısının bağlı olduğu denetim için hedefe özgü işaretlemeyi oluşturur. (Devralındığı yer: ControlAdapter)
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Yanıt akışının hedef URL'sini içeren bir açılış köprü etiketi oluşturur.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Hedef URL'yi ve yanıt akışına erişim anahtarını içeren bir açma köprü etiketi oluşturur.
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)
RenderEndHyperlink(HtmlTextWriter)	Yanıt akışına bir kapanış köprü etiketi oluşturur.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String)	Kodlanmış ve büyük olasılıkla şifrelenmiş görünüm durumu ve olay hedefi ve bağımsız değişkeni dahil olmak üzere geri gönderme olayını yanıt akışına köprü olarak işler.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String)	Kodlanmış ve muhtemelen şifrelenmiş görünüm durumu, olay hedefi ve bağımsız değişkeni, önceki sayfa parametresi ve erişim anahtarı dahil olmak üzere geri gönderme olayını yanıt akışına köprü olarak işler.
RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)	Kodlanmış görünüm durumu, olay hedefi ve bağımsız değişkeni, önceki sayfa parametresi ve erişim anahtarı dahil olmak üzere geri gönderme olayını yanıt akışına köprü olarak işler.
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)
TransformText(String)	Hedef tarayıcının metnini dönüştürür.

Ayrıca bkz.

• ControlAdapter