Sdílet prostřednictvím


HyperLinkColumn Třída

Definice

Typ sloupce pro DataGrid ovládací prvek, který obsahuje hypertextový odkaz pro každou položku ve sloupci.

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
Dědičnost
HyperLinkColumn

Příklady

Následující příklad ukazuje, jak vytvořit HyperLinkColumn odkaz na samostatnou stránku.

Poznámka

Následující ukázka kódu používá model s jedním souborem kódu a nemusí správně fungovat, pokud je zkopírován přímo do souboru s kódem na pozadí. Tento vzorový kód musí být zkopírován do prázdného textového souboru s příponou .aspx. Další informace o modelu kódu webových formulářů najdete v tématu ASP.NET model kódu stránky webových formulářů.

<%@ 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>

Následující odpovídající příklad zobrazuje položku vybranou v předchozím příkladu.

<%@ 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>

Poznámky

HyperLinkColumn Pomocí typu sloupce v ovládacím DataGrid prvku vytvořte hypertextový odkaz pro každý řádek v DataGrid. Text Nastavením vlastnosti zadejte text titulku hypertextového odkazu. Pokud chcete zadat adresu URL, na které se má odkazovat při kliknutí na hypertextový odkaz, nastavte NavigateUrl vlastnost .

Poznámka

Pokud nastavíte Text vlastnosti a NavigateUrl , všechny hypertextové odkazy ve sloupci budou sdílet stejný titulek a adresu URL.

Místo nastavení vlastností a NavigateUrl můžete také vytvořit vazbu textového titulku a adresy URL hypertextových odkazů v objektu HyperLinkColumn s polem ve zdroji Text dat. To vám umožní zobrazit jiný titulek a zadat jinou adresu URL pro každý hypertextový odkaz ve sloupci.

DataTextField Pomocí vlastnosti zadejte pole ve zdroji dat, které se má svázat s textovým titulkem hypertextových odkazů ve sloupci.

Poznámka

Vlastnosti DataTextField a Text nelze nastavit současně. Pokud jsou nastaveny obě vlastnosti, DataTextField má přednost vlastnost .

Nastavením vlastnosti zadejte pole, které se má svázat s adresou URL hypertextového DataNavigateUrlField odkazu.

Poznámka

Vlastnosti DataNavigateUrlField a NavigateUrl nelze nastavit současně. Pokud jsou nastaveny obě vlastnosti, DataNavigateUrlField má přednost vlastnost .

Vlastnost Target umožňuje určit okno nebo rámec pro zobrazení obsahu webové stránky, na který odkazuje při kliknutí na hypertextový odkaz.

Při použití datové vazby můžete naformátovat textový titulek a adresu URL hypertextového odkazu nastavením DataTextFormatString vlastností a DataNavigateUrlFormatString .

Upozornění

Tento ovládací prvek lze použít k zobrazení vstupu uživatele, který může obsahovat škodlivý klientský skript. Před zobrazením v aplikaci zkontrolujte všechny informace odesílané z klienta spustitelný skript, příkazy SQL nebo jiný kód. Ověřovací ovládací prvky můžete použít k ověření vstupu uživatele před zobrazením vstupního textu v ovládacím prvku. ASP.NET poskytuje funkci ověřování vstupních požadavků, která blokuje skript a html v uživatelském vstupu. Další informace najdete v tématech Zabezpečení standardních ovládacích prvků, Postupy: Ochrana před zneužitím skriptů ve webové aplikaci použitím kódování HTML na řetězce a Ověřování vstupu uživatele na ASP.NET webových stránkách.

Konstruktory

HyperLinkColumn()

Inicializuje novou instanci HyperLinkColumn třídy .

Vlastnosti

DataNavigateUrlField

Získá nebo nastaví pole ze zdroje dat na vazbu na adresu URL hypertextových odkazů v objektu HyperLinkColumn.

DataNavigateUrlFormatString

Získá nebo nastaví formát zobrazení pro adresu URL hypertextových odkazů v případě HyperLinkColumn , že je adresa URL vázána na pole ve zdroji dat.

DataTextField

Získá nebo nastaví pole ze zdroje dat na vazbu na textový titulek hypertextových odkazů v objektu HyperLinkColumn.

DataTextFormatString

Získá nebo nastaví formát zobrazení titulku textu hypertextových odkazů ve sloupci HyperLinkColumn .

DesignMode

Získá hodnotu, která označuje, zda je sloupec v režimu návrhu.

(Zděděno od DataGridColumn)
FooterStyle

Získá vlastnosti stylu pro zápatí oddíl sloupce.

(Zděděno od DataGridColumn)
FooterText

Získá nebo nastaví text zobrazený v zápatí oddíl sloupce.

(Zděděno od DataGridColumn)
HeaderImageUrl

Získá nebo nastaví umístění obrázku k zobrazení v záhlaví oddílu sloupce.

(Zděděno od DataGridColumn)
HeaderStyle

Získá vlastnosti stylu pro záhlaví oddíl sloupce.

(Zděděno od DataGridColumn)
HeaderText

Získá nebo nastaví text zobrazený v záhlaví oddílu sloupce.

(Zděděno od DataGridColumn)
IsTrackingViewState

Získá hodnotu, která určuje, zda DataGridColumn je objekt označen k uložení jeho stavu.

(Zděděno od DataGridColumn)
ItemStyle

Získá vlastnosti stylu pro buňky položky sloupce.

(Zděděno od DataGridColumn)
NavigateUrl

Získá nebo nastaví adresu URL odkaz na při kliknutí na hypertextový odkaz ve sloupci.

Owner

DataGrid Získá ovládací prvek, který sloupec je členem.

(Zděděno od DataGridColumn)
SortExpression

Získá nebo nastaví název pole nebo výrazu předat OnSortCommand(DataGridSortCommandEventArgs) metodě při výběru sloupce pro řazení.

(Zděděno od DataGridColumn)
Target

Získá nebo nastaví cílové okno nebo rámec pro zobrazení obsahu webové stránky, který je propojen při kliknutí na hypertextový odkaz ve sloupci.

Text

Získá nebo nastaví titulek textu pro hypertextové odkazy ve sloupci.

ViewState

StateBag Získá objekt, který umožňuje sloupec odvozený z DataGridColumn třídy uložit jeho vlastnosti.

(Zděděno od DataGridColumn)
Visible

Získá nebo nastaví hodnotu, která označuje, zda je sloupec viditelný v ovládacím DataGrid prvku.

(Zděděno od DataGridColumn)

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
FormatDataNavigateUrlValue(Object)

Formátuje adresu URL vázané na data pomocí formátu určeného DataNavigateUrlFormatString vlastností .

FormatDataTextValue(Object)

Zformátuje titulek textu vázaného na data pomocí formátu určeného DataTextFormatString vlastností .

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
Initialize()

Poskytuje základní implementaci pro obnovení sloupce odvozeného z DataGridColumn třídy do jeho počátečního stavu.

InitializeCell(TableCell, Int32, ListItemType)

Inicializuje buňku představující tento sloupec s obsaženým hypertextovým odkazem.

LoadViewState(Object)

Načte stav objektu DataGridColumn .

(Zděděno od DataGridColumn)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
OnColumnChanged()

Zavolá metodu OnColumnsChanged() .

(Zděděno od DataGridColumn)
SaveViewState()

Uloží aktuální stav objektu DataGridColumn .

(Zděděno od DataGridColumn)
ToString()

Vrátí řetězcovou reprezentaci sloupce.

(Zděděno od DataGridColumn)
TrackViewState()

Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru.

(Zděděno od DataGridColumn)

Explicitní implementace rozhraní

IStateManager.IsTrackingViewState

Získá hodnotu, která označuje, zda sloupec sleduje změny stavu zobrazení.

(Zděděno od DataGridColumn)
IStateManager.LoadViewState(Object)

Načte dříve uložený stav.

(Zděděno od DataGridColumn)
IStateManager.SaveViewState()

Vrátí objekt obsahující změny stavu.

(Zděděno od DataGridColumn)
IStateManager.TrackViewState()

Začne sledovat změny stavu.

(Zděděno od DataGridColumn)

Platí pro

Viz také