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 kódu s jedním souborem a nemusí správně fungovat, pokud se zkopíruje přímo do souboru s kódem. Tento ukázkový kód se musí zkopírovat do prázdného textového souboru s příponou .aspx. Další informace o modelu kódu Web Forms najdete v tématu ASP.NET Web Forms Model kódu stránky.

<%@ 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 ovládacím DataGridprvku . Text Nastavte vlastnost tak, aby určila text titulku hypertextového odkazu. Chcete-li zadat adresu URL, na které se má odkazovat po kliknutí na hypertextový odkaz, nastavte NavigateUrl vlastnost.

Poznámka

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

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

DataTextField Vlastnost slouží k určení pole ve zdroji dat, které se má svázat s textovým titulkem hypertextových odkazů ve sloupci.

Poznámka

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

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

Poznámka

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

Tato Target vlastnost umožňuje zadat okno nebo rámeček pro zobrazení obsahu webové stránky propojeného s po 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 a DataNavigateUrlFormatString vlastnostmi.

Upozornění

Tento ovládací prvek lze použít k zobrazení uživatelského vstupu, který může zahrnovat škodlivý klientský skript. Před zobrazením v aplikaci zkontrolujte všechny informace odeslané z klienta pro spustitelný skript, SQL příkazy nebo jiný kód. Ovládací prvky ověřování můžete použít k ověření uživatelského vstupu 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 ve vstupu uživatele. Další informace naleznete v tématu 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í uživatelských vstupů na webových stránkách ASP.NET.

Konstruktory

HyperLinkColumn()

Inicializuje novou instanci HyperLinkColumn třídy.

Vlastnosti

DataNavigateUrlField	Získá nebo nastaví pole ze zdroje dat pro vazbu na adresu URL hypertextových odkazů v souboru HyperLinkColumn.
DataNavigateUrlFormatString	Získá nebo nastaví formát zobrazení pro adresu URL hypertextových odkazů v HyperLinkColumn případě, že adresa URL je vázána na pole ve zdroji dat.
DataTextField	Získá nebo nastaví pole ze zdroje dat tak, aby se svázat s textovým titulkem hypertextových odkazů v souboru HyperLinkColumn.
DataTextFormatString	Získá nebo nastaví formát zobrazení pro textový titulek hypertextových odkazů ve HyperLinkColumn sloupci.
DesignMode	Získá hodnotu, která označuje, zda sloupec je v režimu návrhu. (Zděděno od DataGridColumn)
FooterStyle	Získá vlastnosti stylu pro oddíl zápatí sloupce. (Zděděno od DataGridColumn)
FooterText	Získá nebo nastaví text zobrazený v oddílu zápatí sloupce. (Zděděno od DataGridColumn)
HeaderImageUrl	Získá nebo nastaví umístění obrázku, který se zobrazí v oddílu záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderStyle	Získá vlastnosti stylu pro oddíl záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderText	Získá nebo nastaví text zobrazený v oddílu záhlaví 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 ve sloupci. (Zděděno od DataGridColumn)
NavigateUrl	Získá nebo nastaví adresu URL tak, aby odkaz na odkaz v případě kliknutí na hypertextový odkaz ve sloupci.
Owner	DataGrid Získá ovládací prvek, ze kterého je sloupec členem. (Zděděno od DataGridColumn)
SortExpression	Získá nebo nastaví název pole nebo výrazu pro předání 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ý s hypertextovým odkazem ve sloupci.
Text	Získá nebo nastaví textový titulek pro zobrazení hypertextových odkazů ve sloupci.
ViewState	StateBag Získá objekt, který umožňuje sloupec odvozený z DataGridColumn třídy ukládat jeho vlastnosti. (Zděděno od DataGridColumn)
Visible	Získá nebo nastaví hodnotu, která označuje, jestli 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)	Formátuje popisek textu vázaného na data pomocí formátu určeného DataTextFormatString vlastností.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Initialize()	Poskytuje základní implementaci pro resetování sloupce odvozeného z DataGridColumn třídy do původní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ří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnColumnChanged()	Volá 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í ovládacího prvku serveru, aby je bylo možné uložit do objektu StateBag ovládacího prvku 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()	Spustí sledování změn stavu. (Zděděno od DataGridColumn)

Platí pro

HyperLinkColumn Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Další materiály