HyperLinkColumn Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

En kolumntyp för kontrollen DataGrid som innehåller en hyperlänk för varje objekt i kolumnen.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn
public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn
type HyperLinkColumn = class
    inherit DataGridColumn
Public Class HyperLinkColumn
Inherits DataGridColumn
Arv
Object
DataGridColumn
HyperLinkColumn

Exempel

I följande exempel visas hur du skapar en HyperLinkColumn som länkar till en separat sida.

Note

Följande kodexempel använder kodmodellen med en fil och kanske inte fungerar korrekt om den kopieras direkt till en kod bakom-fil. Det här kodexemplet måste kopieras till en tom textfil som har ett .aspx-tillägg. Mer information om kodmodellen Web Forms finns i ASP.NET Web Forms Page Code Model.

<%@ 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"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 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"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

I följande motsvarande exempel visas det objekt som valts i föregående exempel.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<script runat="server">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

Kommentarer

HyperLinkColumn Använd kolumntypen i en DataGrid kontroll för att skapa en hyperlänk för varje rad i DataGrid. Text Ange egenskapen för att ange bildtexten för hyperlänken. Ange egenskapen för att ange url:en som ska länkas till när hyperlänken NavigateUrl klickas.

Note

Om du anger Text egenskaperna och NavigateUrl delar alla hyperlänkar i kolumnen samma bildtext och URL.

Du kan också binda textrubriken och URL:en för hyperlänkarna i HyperLinkColumn till ett fält i en datakälla i stället för att Text ange egenskaperna och NavigateUrl . På så sätt kan du visa en annan undertext och ange en annan URL för varje hyperlänk i kolumnen.

Använd egenskapen DataTextField för att ange ett fält i en datakälla som ska bindas till textrubriken för hyperlänkarna i kolumnen.

Note

Egenskaperna DataTextField och Text kan inte båda anges samtidigt. Om båda egenskaperna anges har egenskapen DataTextField företräde.

Ange det fält som ska bindas till url:en för hyperlänken genom att ange DataNavigateUrlField egenskapen .

Note

Egenskaperna DataNavigateUrlField och NavigateUrl kan inte båda anges samtidigt. Om båda egenskaperna anges har egenskapen DataNavigateUrlField företräde.

Med Target egenskapen kan du ange fönstret eller ramen för att visa det webbplatsinnehåll som är länkat till när hyperlänken klickas.

När du använder databindning kan du formatera textrubriken och URL:en för hyperlänken genom att ange DataTextFormatString egenskaperna och DataNavigateUrlFormatString .

Caution

Den här kontrollen kan användas för att visa användarindata, som kan innehålla skadligt klientskript. Kontrollera all information som skickas från en klient för körbart skript, SQL-instruktioner eller annan kod innan du visar den i ditt program. Du kan använda verifieringskontroller för att verifiera användarindata innan du visar indatatexten i en kontroll. ASP.NET tillhandahåller en funktion för validering av indatabegäran för att blockera skript och HTML i användarindata. Mer information finns i se Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Validating User Input in in ASP.NET Web Pages.

Konstruktorer

Name Description
HyperLinkColumn()

Initierar en ny instans av HyperLinkColumn klassen.

Egenskaper

Name Description
DataNavigateUrlField

Hämtar eller anger fältet från en datakälla för att binda till URL:en för hyperlänkarna i HyperLinkColumn.
DataNavigateUrlFormatString

Hämtar eller anger visningsformatet för URL:en för hyperlänkarna i HyperLinkColumn när URL:en är databunden till ett fält i en datakälla.
DataTextField

Hämtar eller anger fältet från en datakälla för att binda till textrubriken för hyperlänkarna i HyperLinkColumn.
DataTextFormatString

Hämtar eller anger visningsformatet för textrubriken för hyperlänkarna i HyperLinkColumn kolumnen.
DesignMode

Hämtar ett värde som anger om kolumnen är i designläge.

(Ärvd från DataGridColumn)
FooterStyle

Hämtar formategenskaperna för sidfotsavsnittet i kolumnen.

(Ärvd från DataGridColumn)
FooterText

Hämtar eller anger texten som visas i sidfotsavsnittet i kolumnen.

(Ärvd från DataGridColumn)
HeaderImageUrl

Hämtar eller anger platsen för en bild som ska visas i rubrikavsnittet i kolumnen.

(Ärvd från DataGridColumn)
HeaderStyle

Hämtar formategenskaperna för rubrikavsnittet i kolumnen.

(Ärvd från DataGridColumn)
HeaderText

Hämtar eller anger texten som visas i rubrikavsnittet i kolumnen.

(Ärvd från DataGridColumn)
IsTrackingViewState

Hämtar ett värde som avgör om DataGridColumn objektet är markerat för att spara dess tillstånd.

(Ärvd från DataGridColumn)
ItemStyle

Hämtar formategenskaperna för objektcellerna i kolumnen.

(Ärvd från DataGridColumn)
NavigateUrl

Hämtar eller anger url:en som ska länkas till när en hyperlänk i kolumnen klickas.
Owner

Hämtar kontrollen DataGrid som kolumnen är medlem i.

(Ärvd från DataGridColumn)
SortExpression

Hämtar eller anger namnet på fältet eller uttrycket som ska skickas till OnSortCommand(DataGridSortCommandEventArgs) metoden när en kolumn har valts för sortering.

(Ärvd från DataGridColumn)
Target

Hämtar eller anger målfönstret eller ramen för att visa det webbplatsinnehåll som är länkat till när hyperlänken i kolumnen klickas.
Text

Hämtar eller anger textrubriken som ska visas för hyperlänkarna i kolumnen.
ViewState

Hämtar objektet StateBag som tillåter att en kolumn som härleds DataGridColumn från klassen lagrar dess egenskaper.

(Ärvd från DataGridColumn)
Visible

Hämtar eller anger ett värde som anger om kolumnen visas i DataGrid kontrollen.

(Ärvd från DataGridColumn)

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
FormatDataNavigateUrlValue(Object)

Formaterar en databunden URL med det format som anges av DataNavigateUrlFormatString egenskapen.
FormatDataTextValue(Object)

Formaterar en databunden textrubrik med det format som anges av DataTextFormatString egenskapen.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Initialize()

Tillhandahåller basimplementeringen för att återställa en kolumn som härletts DataGridColumn från klassen till dess ursprungliga tillstånd.
InitializeCell(TableCell, Int32, ListItemType)

Initierar cellen som representerar den här kolumnen med den inneslutna hyperlänken.
LoadViewState(Object)

Läser in objektets DataGridColumn tillstånd.

(Ärvd från DataGridColumn)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnColumnChanged()

Anropar metoden OnColumnsChanged().

(Ärvd från DataGridColumn)
SaveViewState()

Sparar objektets aktuella tillstånd DataGridColumn .

(Ärvd från DataGridColumn)
ToString()

Returnerar strängrepresentationen av kolumnen.

(Ärvd från DataGridColumn)
TrackViewState()

Orsakar spårning av visningstillståndsändringar i serverkontrollen så att de kan lagras i serverkontrollens StateBag objekt.

(Ärvd från DataGridColumn)

Explicita gränssnittsimplementeringar

Name Description
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om kolumnen spårar visningstillståndsändringar.

(Ärvd från DataGridColumn)
IStateManager.LoadViewState(Object)

Läser in tidigare sparat tillstånd.

(Ärvd från DataGridColumn)
IStateManager.SaveViewState()

Returnerar ett objekt som innehåller tillståndsändringar.

(Ärvd från DataGridColumn)
IStateManager.TrackViewState()

Börjar spåra tillståndsändringar.

(Ärvd från DataGridColumn)

Gäller för

Se även