HyperLinkColumn.Text 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
열의 하이퍼링크에 대해 표시할 텍스트 캡션을 가져오거나 설정합니다.
public:
virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };public virtual string Text { get; set; }member this.Text : string with get, setPublic Overridable Property Text As String속성 값
열의 하이퍼링크에 대한 텍스트 캡션입니다. 기본값은 Empty입니다.
예제
다음 예제에서는 하이퍼링크에 Text 대 한 텍스트 캡션을 지정 하는 속성을 사용 하는 방법을 보여 줍니다 HyperLinkColumn. 열의 모든 하이퍼링크에는 동일한 텍스트 캡션이 있습니다.
메모
다음 코드 샘플에서는 단일 파일 코드 모델을 사용하며 코드 숨김 파일에 직접 복사한 경우 제대로 작동하지 않을 수 있습니다. 이 코드 샘플은 .aspx 확장이 있는 빈 텍스트 파일로 복사해야 합니다. Web Forms 코드 모델에 대한 자세한 내용은 ASP.NET Web Forms 페이지 코드 모델을 참조하세요.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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>
<title>HyperLinkColumn Example</title>
<script runat="server">
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
for (int i = 0; i < 3; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = (Double)i * 1.23;
dt.Rows.Add(dr);
}
DataView dv = new DataView(dt);
return dv;
}
void Page_Load(Object sender, EventArgs e)
{
MyDataGrid.DataSource = CreateDataSource();
MyDataGrid.DataBind();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkColumn Example</h3>
<asp:DataGrid id="MyDataGrid"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
AutoGenerateColumns="false"
runat="server">
<HeaderStyle BackColor="#aaaadd"/>
<Columns>
<asp:HyperLinkColumn
HeaderText="Select an Item"
NavigateUrl="detailspage.aspx"
Text="Click Me"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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>
<title>HyperLinkColumn Example</title>
<script runat="server">
Function CreateDataSource() As ICollection
Dim dt As DataTable = New DataTable()
Dim dr As DataRow
Dim i As Integer
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
For i = 0 to 2
dr = dt.NewRow()
dr(0) = i
dr(1) = CDbl(i) * 1.23
dt.Rows.Add(dr)
Next i
Dim dv As DataView = New DataView(dt)
Return dv
End Function
Sub Page_Load(sender As Object, e As EventArgs)
MyDataGrid.DataSource = CreateDataSource()
MyDataGrid.DataBind()
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkColumn Example</h3>
<asp:DataGrid id="MyDataGrid"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
AutoGenerateColumns="false"
runat="server">
<HeaderStyle BackColor="#aaaadd"/>
<Columns>
<asp:HyperLinkColumn
HeaderText="Select an Item"
NavigateUrl="detailspage.aspx"
Text="Click Me"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
다음 예제는 이전 예제의 하이퍼링크를 클릭할 때 연결할 샘플 Web Forms 페이지입니다.
<%@ 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>
<title>Details page for DataGrid</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Details page for DataGrid</h3>
Welcome to the new page.
</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>
<title>Details page for DataGrid</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Details page for DataGrid</h3>
Welcome to the new page.
</form>
</body>
</html>
설명
열의 Text 하이퍼링크에 대해 표시할 텍스트 캡션을 지정하려면 이 속성을 사용합니다.
메모
이 속성을 설정하면 열의 모든 하이퍼링크가 동일한 텍스트 캡션을 공유합니다.
열의 각 하이퍼링크에 대해 별도의 텍스트 캡션을 제공하려면 속성을 사용합니다 DataTextField .
메모
DataTextField 속성과 Text 속성을 동시에 설정할 수 없습니다. 두 속성이 모두 설정되면 속성이 DataTextField 우선합니다.
주의
텍스트가 HTML로 인코딩되지 않은 경우 HyperLinkColumn. 이렇게 하면 텍스트의 HTML 태그 내에 스크립트를 포함할 수 있습니다. 이 열의 값이 사용자 입력에서 나온 경우 보안 취약성을 줄이기 위해 값의 유효성을 검사해야 합니다.
설정 시 이 속성의 값은 디자이너 도구를 사용하여 리소스 파일에 자동으로 저장할 수 있습니다. 자세한 내용은 세계화 및 지역화를 참조 LocalizableAttribute 하세요.
