HyperLinkField 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 바인딩된 컨트롤에 하이퍼링크로 표시되는 필드를 나타냅니다.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlField
public class HyperLinkField : System.Web.UI.WebControls.DataControlField
type HyperLinkField = class
inherit DataControlField
Public Class HyperLinkField
Inherits DataControlField
- 상속
예제
다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 HyperLinkField 에 정적 하이퍼링크의 열을 표시 하는 개체는 GridView 제어 합니다. 각 하이퍼링크를 HyperLinkField 개체에서 지정한 동일한 캡션과 탐색 URL을 공유 합니다 Text 및 NavigateUrl 속성을 각각.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
다음 코드 예제에 바인딩하는 방법을 보여는 HyperLinkField 데이터 원본의 필드에는 개체입니다. DataTextField 하 고 DataNavigateUrlFields 속성에 표시 되는 각 하이퍼링크의 각각 캡션과 탐색 URL에 바인딩할 필드 지정을 사용 하는 HyperLinkField 개체입니다.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
설명
합니다 HyperLinkField 클래스는 데이터 바인딩된 컨트롤에서 사용 됩니다 (같은 GridView 및 DetailsView) 표시 되는 각 레코드에 대 한 하이퍼링크를 표시 하려면. 사용자가 하이퍼링크를 클릭하면 하이퍼링크와 연결된 웹 페이지로 이동됩니다. HyperLinkField 개체가 사용 되는 데이터 바인딩된 컨트롤에 따라 다르게 표시 됩니다. 예를 들어 합니다 GridView 컨트롤이 표시를 HyperLinkField 열을 개체로 하는 동안를 DetailsView 컨트롤 행으로 표시 합니다.
하이퍼링크에 대해 표시할 캡션을 지정 하려면 사용 된 Text 속성입니다. 사용 된 NavigateUrl 하이퍼링크를 클릭할 때 탐색할 URL을 지정 하는 속성입니다. 연결된 된 콘텐츠의 특정 창이 나 프레임을 표시 하려는 경우 설정 된 Target 속성입니다.
참고
경우는 Text 및 NavigateUrl 속성이 설정 된 모든 하이퍼링크는 HyperLinkField 동일한 캡션과 탐색 URL을 공유 하는 개체입니다. 마찬가지로,는 Target 속성 모든 하이퍼링크에도 적용 됩니다.
바인딩할 수 있습니다는 HyperLinkField 개체 데이터 소스의 필드입니다. 각 하이퍼링크에 대해 여러 캡션을 표시할 수 있습니다는 HyperLinkField 개체와 다른 위치를 탐색 합니다. 필드는 캡션에 바인딩할 설정 된 DataTextField 속성입니다. 탐색에 대 한 URL을 만들려면 설정 된 DataNavigateUrlFields URL을 만드는 데 사용할 필드를 쉼표로 구분 된 목록에는 속성입니다.
캡션 및 탐색 Url에 대 한 사용자 지정 형식을 설정 하 여 지정할 수 있습니다 합니다 DataTextFormatString 고 DataNavigateUrlFormatString 속성을 각각.
숨길 수 있습니다는 HyperLinkField 설정 하 여 데이터 바인딩된 컨트롤에 개체를 Visible 속성을 false
입니다.
머리글 및 바닥글 섹션을 사용자 지정할 수는 HyperLinkField 개체입니다. 캡션을 머리글 또는 바닥글 구역에 표시할 설정 합니다 HeaderText 또는 FooterText 속성을 각각. 텍스트 대신 헤더 섹션에는 이미지를 표시 하려면 설정의 HeaderImageUrl 속성입니다. 헤더 섹션에 숨겨져 있을 수는 HyperLinkField 설정 하 여 개체를 ShowHeader 속성을 false
입니다.
참고
일부 데이터 바인딩된 컨트롤 (같은 GridView 컨트롤) 표시 하거나 컨트롤의 전체 헤더 섹션을 숨길 수 있습니다. 이러한 데이터 바인딩된 컨트롤을 지원 하지 않습니다는 ShowHeader 개별 바인딩된 필드의 속성입니다. 컨트롤의 사용을 표시 하거나 숨기려면 데이터 바인딩된 컨트롤의 전체 헤더 섹션 하 여 ShowHeader
속성 (있는 경우).
또한 사용자 지정할 수 있습니다 모양의 HyperLinkField 필드의 다른 부분에 대 한 스타일 속성을 설정 하 여 개체 (글꼴 색, 배경색 및 등). 다음 표에서 다양 한 스타일 속성을 나열합니다.
스타일 속성 | Description |
---|---|
ControlStyle | 자식 웹 서버 컨트롤에 대 한 스타일 설정을 HyperLinkField 개체입니다. |
FooterStyle | 바닥글 구역에 대 한 스타일 설정을 HyperLinkField 개체입니다. |
HeaderStyle | 머리글 구역에 대 한 스타일 설정을 HyperLinkField 개체입니다. |
ItemStyle | 데이터 항목에 대 한 스타일 설정이 HyperLinkField 개체입니다. |
생성자
HyperLinkField() |
HyperLinkField 클래스의 새 인스턴스를 초기화합니다. |
속성
AccessibleHeaderText |
일부 컨트롤에서 |
Control |
DataControlField 개체가 연결된 데이터 컨트롤에 대한 참조를 가져옵니다. (다음에서 상속됨 DataControlField) |
ControlStyle |
DataControlField 개체에 포함된 웹 서버 컨트롤의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
DataNavigateUrlFields |
HyperLinkField 개체의 하이퍼링크에 대한 URL을 만드는 데 사용되는 데이터 소스의 필드 이름을 가져오거나 설정합니다. |
DataNavigateUrlFormatString |
HyperLinkField 개체의 하이퍼링크에 대한 URL이 렌더링되는 형식을 지정하는 문자열을 가져오거나 설정합니다. |
DataTextField |
HyperLinkField 개체의 하이퍼링크 캡션에 대해 표시할 텍스트를 포함하는 데이터 소스의 필드 이름을 가져오거나 설정합니다. |
DataTextFormatString |
HyperLinkField 개체의 하이퍼링크 캡션이 표시되는 형식을 지정하는 문자열을 가져오거나 설정합니다. |
DesignMode |
데이터 컨트롤 필드가 현재 디자인 타임 환경에서 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
FooterStyle |
데이터 컨트롤 필드의 바닥글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
FooterText |
데이터 컨트롤 필드의 바닥글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
HeaderImageUrl |
데이터 컨트롤 필드의 머리글 항목에 표시되는 이미지의 URL을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
HeaderStyle |
데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
HeaderText |
데이터 컨트롤 필드의 머리글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
InsertVisible |
데이터 바인딩된 부모 컨트롤이 삽입 모드에 있는 경우 DataControlField 개체가 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
IsTrackingViewState |
DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
ItemStyle |
데이터 컨트롤 필드에 표시되는 텍스트 기반 내용의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
NavigateUrl |
HyperLinkField 개체의 하이퍼링크를 클릭할 때 탐색할 URL을 가져오거나 설정합니다. |
ShowHeader |
데이터 컨트롤 필드의 머리글 항목이 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
SortExpression |
데이터 소스 컨트롤에서 데이터를 정렬하는 데 사용되는 정렬 식을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
Target |
HyperLinkField 개체의 하이퍼링크를 클릭할 때 링크되는 웹 페이지를 표시할 대상 창이나 프레임을 가져오거나 설정합니다. |
Text |
HyperLinkField 개체의 각 하이퍼링크에 대해 표시할 텍스트를 가져오거나 설정합니다. |
ValidateRequestMode |
컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
ViewState |
같은 페이지에 대한 여러 개의 요청 전반에 DataControlField 개체의 뷰 상태를 저장하고 복원하는 데 사용할 수 있는 상태 정보 사전을 가져옵니다. (다음에서 상속됨 DataControlField) |
Visible |
데이터 컨트롤 필드가 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
메서드
명시적 인터페이스 구현
IDataSourceViewSchemaAccessor.DataSourceViewSchema |
이 DataControlField 개체에 연결된 스키마를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
IStateManager.IsTrackingViewState |
DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
IStateManager.LoadViewState(Object) |
데이터 컨트롤 필드를 이전에 저장된 뷰 상태로 복원합니다. (다음에서 상속됨 DataControlField) |
IStateManager.SaveViewState() |
페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다. (다음에서 상속됨 DataControlField) |
IStateManager.TrackViewState() |
DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다. (다음에서 상속됨 DataControlField) |