HyperLinkColumn Třída

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 odkazy na samostatnou stránku.

Poznámka:

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

<%@ 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 zobrazí 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ího DataGridprvku . Text Nastavte vlastnost tak, aby určila text titulku hypertextového odkazu. Chcete-li 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 vlastnosti, budou všechny hypertextové odkazy ve sloupci sdílet stejný titulek a adresu URL.

Místo nastavení Text a NavigateUrl vlastností můžete vytvořit vazbu textového titulku a adresy URL hypertextových odkazů v HyperLinkColumn poli ve zdroji dat. To vám umožní 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é má vytvořit vazbu na textový titulek hypertextových odkazů ve sloupci.

Poznámka:

Text Obě vlastnosti DataTextField nelze nastavit současně. Pokud jsou nastaveny obě vlastnosti, 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:

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

Vlastnost Target umožňuje zadat okno nebo rámec pro zobrazení obsahu webové stránky propojeného s hypertextovým odkazem při kliknutí na hypertextový odkaz.

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

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 odeslané z klienta pro spustitelný skript, příkazy SQL nebo jiný kód. Ověřovací ovládací prvky 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ů pro blokování skriptu a kódu 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ého vstupu na ASP.NET webových stránek.

Konstruktory

Name	Description
HyperLinkColumn()	Inicializuje novou instanci HyperLinkColumn třídy.

Vlastnosti

Name	Description
DataNavigateUrlField	Získá nebo nastaví pole ze zdroje dat pro 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 HyperLinkColumn případě, že adresa URL je vázána na pole ve zdroji dat.
DataTextField	Získá nebo nastaví pole ze zdroje dat pro vazbu na textový titulek hypertextových odkazů v objektu HyperLinkColumn.
DataTextFormatString	Získá nebo nastaví formát zobrazení pro textový titulek 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 oddíl zápatí sloupce. (Zděděno od DataGridColumn)
FooterText	Získá nebo nastaví text zobrazený v zápatí oddílu 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 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 ve sloupci. (Zděděno od DataGridColumn)
NavigateUrl	Získá nebo nastaví adresu URL na odkaz, na který se klikne hypertextový odkaz ve sloupci.
Owner	DataGrid Získá ovládací prvek, který je sloupec členem. (Zděděno od DataGridColumn)
SortExpression	Získá nebo nastaví název pole nebo výraz předat metodě OnSortCommand(DataGridSortCommandEventArgs) 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 je kliknutí.
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 uložit jeho vlastnosti. (Zděděno od DataGridColumn)
Visible	Získá nebo nastaví hodnotu, která určuje, zda je sloupec viditelný v ovládacím DataGrid prvku. (Zděděno od DataGridColumn)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven 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 vlastností DataNavigateUrlFormatString .
FormatDataTextValue(Object)	Formátuje textový titulek vázaného na data pomocí formátu určeného vlastností DataTextFormatString .
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
Initialize()	Poskytuje základní implementaci pro resetování sloupce odvozeného z třídy do původního DataGridColumn stavu.
InitializeCell(TableCell, Int32, ListItemType)	Inicializuje buňku představující tento sloupec pomocí obsaženého hypertextového odkazu.
LoadViewState(Object)	Načte stav objektu DataGridColumn . (Zděděno od DataGridColumn)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního 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í v ovládacím 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í

Name	Description
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

Viz také

Váš názor

Byla tato stránka užitečná?

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