PageAdapter.RenderBeginHyperlink 메서드

참조

정의

네임스페이스:: System.Web.UI.Adapters

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

여는 하이퍼링크 태그를 응답 스트림으로 렌더링합니다.

오버로드

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	대상 URL이 포함된 여는 하이퍼링크 태그를 응답 스트림으로 렌더링합니다.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	액세스 키와 대상 URL이 포함된 여는 하이퍼링크 태그를 응답 스트림으로 렌더링합니다.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

대상 URL이 포함된 여는 하이퍼링크 태그를 응답 스트림으로 렌더링합니다.

public:
 virtual void RenderBeginHyperlink(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ targetUrl, bool encodeUrl, System::String ^ softkeyLabel);

public virtual void RenderBeginHyperlink (System.Web.UI.HtmlTextWriter writer, string targetUrl, bool encodeUrl, string softkeyLabel);

abstract member RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string -> unit
override this.RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string -> unit

Public Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String)

매개 변수

writer: HtmlTextWriter

대상별 출력을 렌더링하는 메서드가 포함된 HtmlTextWriter입니다.

targetUrl: String

링크의 대상 URL을 보유하고 있는 String 값입니다.

encodeUrl: Boolean

HtmlAttributeEncode(String)를 사용하여 스트림 출력을 인코딩하려면 true이고, 그렇지 않으면 false입니다.

softkeyLabel: String

소프트 키 레이블로 사용할 String 값입니다.

예제

다음 코드 예제에서는 라는 클래스를 파생 하는 방법을 보여 줍니다 CustomPageAdapter 에서 합니다 PageAdapter 클래스를 재정의 RenderBeginHyperlink 메서드. 합니다 RenderBeginHyperlink 이라는 특성을 추가 하는 메서드 src 하이퍼링크는 현재 페이지에 대 한 참조를 포함 합니다. 페이지를 렌더링 하는 모든 하이퍼링크 CustomPageAdapter 연결 해야 합니다 src 특성입니다.

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

설명

RenderBeginHyperlink 메서드 기록에 여는 하이퍼링크 태그입니다. 때 writer 는 HtmlTextWriter,이 태그는 다음 형식:

<a href=" targetUrl ">

상속자 참고

상속 하는 경우는 PageAdapter 재정의할 수 있습니다 클래스는 RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) 태그 또는 추가 태그를 쓸 특성을 여는 하이퍼링크에 대 한 다른 형식으로 작성 하는 방법입니다. 예를 들어 합니다 RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) 기본 메서드에서 특성을 기록 하지 않습니다 softkeyLabel합니다.

추가 정보

적용 대상

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

액세스 키와 대상 URL이 포함된 여는 하이퍼링크 태그를 응답 스트림으로 렌더링합니다.

public:
 virtual void RenderBeginHyperlink(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ targetUrl, bool encodeUrl, System::String ^ softkeyLabel, System::String ^ accessKey);

public virtual void RenderBeginHyperlink (System.Web.UI.HtmlTextWriter writer, string targetUrl, bool encodeUrl, string softkeyLabel, string accessKey);

abstract member RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string * string -> unit
override this.RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string * string -> unit

Public Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String, accessKey As String)

매개 변수

writer: HtmlTextWriter

대상별 출력을 렌더링하는 메서드가 포함된 HtmlTextWriter입니다.

targetUrl: String

링크의 대상 URL을 보유하고 있는 String 값입니다.

encodeUrl: Boolean

HtmlAttributeEncode(String)를 사용하여 스트림 출력을 인코딩하려면 true이고, 그렇지 않으면 false입니다.

softkeyLabel: String

소프트 키 레이블로 사용할 String 값입니다.

accessKey: String

만들 링크의 accessKey 특성에 할당할 String 값입니다.

예외

ArgumentOutOfRangeException

accessKey가 한 문자보다 긴 경우

예제

다음 코드 예제에서는 라는 클래스를 파생 하는 방법을 보여 줍니다 CustomPageAdapter 에서 합니다 PageAdapter 클래스를 재정의 RenderBeginHyperlink 메서드. RenderBeginHyperlink 명명 된 특성을 추가 src 하이퍼링크는 현재 페이지에 대 한 참조를 포함 합니다. 페이지를 렌더링 하는 모든 하이퍼링크 CustomPageAdapter 연결 해야 합니다 src 특성입니다.

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

설명

RenderBeginHyperlink 메서드 기록에 여는 하이퍼링크 태그입니다. 때 writer 되는 HtmlTextWriter 개체를이 태그는 다음 형식:

<a href=" targetUrl " accessKey=" accessKey ">

상속자 참고

상속 하는 경우는 PageAdapter 재정의할 수 있습니다 클래스는 RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) 태그 또는 추가 태그를 쓸 특성을 여는 하이퍼링크에 대 한 다른 형식으로 작성 하는 방법입니다. 예를 들어 합니다 RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) 기본 메서드에서 특성을 기록 하지 않습니다 softkeyLabel합니다.

추가 정보

적용 대상

다음을 통해 공유

PageAdapter.RenderBeginHyperlink 메서드

정의

오버로드

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

매개 변수

예제

설명

상속자 참고

추가 정보

적용 대상

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

매개 변수

예외

예제

설명

상속자 참고

추가 정보

적용 대상

추가 리소스