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 값입니다.

예제

다음 코드 예제에서는 PageAdapter 클래스에서 CustomPageAdapter 명명 된 클래스를 파생 하 고 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 한 문자보다 깁니다.

예제

다음 코드 예제에서는 PageAdapter 클래스에서 CustomPageAdapter 명명 된 클래스를 파생 하 고 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)

매개 변수

예외

예제

설명

상속자 참고

추가 정보

적용 대상

피드백

추가 리소스