HyperLinkColumn Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object

DataGridColumn
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

Sdílet prostřednictvím

HyperLinkColumn Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Váš názor

Další materiály