PageAdapter Sınıf

Tanım

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

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• ControlAdapter