Tento článek byl přeložen strojově počítačem. Původní text zobrazíte přesunutím ukazatele myši nad jednotlivé věty článku. Další informace

Překlad

Originál

Toto téma nebylo dosud ohodnoceno - Ohodnotit toto téma

HyperLinkColumn – třída

.NET Framework 4.5

Ostatní verze

.NET Framework 4

Pro typ sloupce DataGrid ovládací prvek obsahující hypertextový odkaz pro každou položku ve sloupci.

Hierarchie dědičnosti

System.Object
System.Web.UI.WebControls.DataGridColumn
System.Web.UI.WebControls.HyperLinkColumn

Obor názvů: System.Web.UI.WebControls
Sestavení: System.Web (v System.Web.dll)

Syntaxe

C++

public class HyperLinkColumn : DataGridColumn

Typ HyperLinkColumn zveřejňuje následující členy.

Konstruktory

	Název	Popis
	HyperLinkColumn	Vytvoří novou instanci třídy HyperLinkColumn.

Nahoru

Vlastnosti

	Název	Popis
	DataNavigateUrlField	Získá nebo nastaví pole ze zdroje dat vytvořit vazbu na adresu URL hypervazby v HyperLinkColumn.
	DataNavigateUrlFormatString	Získá nebo nastaví formát zobrazení adresy URL hypertextové odkazy v HyperLinkColumn při URL je vázán na data ve zdroji dat pole.
	DataTextField	Získá nebo nastaví pole ze zdroje dat vytvořit vazbu na hypertextové odkazy v textu titulku HyperLinkColumn.
	DataTextFormatString	Získá nebo nastaví formát zobrazení hypertextové odkazy v textu titulku HyperLinkColumn sloupce.
	DesignMode	Získá hodnota, která určuje, zda je sloupec v návrhovém režimu. (Zděděno z DataGridColumn.)
	FooterStyle	Získá vlastnosti styl oddílu zápatí sloupce. (Zděděno z DataGridColumn.)
	FooterText	Získá nebo nastaví text zobrazený v zápatí sloupce. (Zděděno z DataGridColumn.)
	HeaderImageUrl	Získá nebo nastaví umístění obrázku, který chcete zobrazit v záhlaví sloupce. (Zděděno z DataGridColumn.)
	HeaderStyle	Získá vlastnosti stylu pro záhlaví sloupce. (Zděděno z DataGridColumn.)
	HeaderText	Získá nebo nastaví text zobrazený v záhlaví sloupce. (Zděděno z DataGridColumn.)
	IsTrackingViewState	Získá hodnotu, která určuje, zda DataGridColumn objekt označen k uložení stavu. (Zděděno z DataGridColumn.)
	ItemStyle	Získá vlastnosti stylu pro položku buňky sloupce. (Zděděno z DataGridColumn.)
	NavigateUrl	Získá nebo nastaví adresu URL po klepnutí na hypertextový odkaz ve sloupci propojení.
	Owner	Získává DataGrid ovládací prvek, který sloupec je členem. (Zděděno z DataGridColumn.)
	SortExpression	Získá nebo nastaví název pole nebo výraz k předání OnSortCommand metoda vyberete sloupec pro řazení. (Zděděno z DataGridColumn.)
	Target	Získá nebo nastaví cílové okno nebo rámeček pro zobrazení obsahu webové stránky, který je propojen po klepnutí na hypertextový odkaz ve sloupci.
	Text	Získá nebo nastaví titulek text k zobrazení hypertextových odkazů ve sloupci.
	ViewState	Získává System.Web.UI.StateBag objekt, který umožňuje sloupec odvozené z DataGridColumn třídy pro uložení jeho vlastnosti. (Zděděno z DataGridColumn.)
	Visible	Získá nebo nastaví hodnotu, která označuje, zda je zobrazen ve sloupci DataGrid řízení. (Zděděno z DataGridColumn.)

Nahoru

Metody

	Název	Popis
	Equals(Object)	Určuje, zda zadaný objekt je rovno aktuální objekt. (Zděděno z Object.)
	Finalize	Umožňuje objektu pokusit se uvolnit prostředky a provést další operace vyčištění předtím, než je odstraněn při uvolňování paměti. (Zděděno z Object.)
	FormatDataNavigateUrlValue	Formáty URL vázán na data pomocí formátu zadaném DataNavigateUrlFormatString vlastnost.
	FormatDataTextValue	Formáty vázán na data, text titulku pomocí formátu zadaném DataTextFormatString vlastnost.
	GetHashCode	Slouží jako funkce hash určitého typu. (Zděděno z Object.)
	GetType	Získává Type aktuální instance. (Zděděno z Object.)
	Initialize	Poskytuje základní implementace obnovit sloupce z DataGridColumn třídy do původního stavu. (Přepisuje DataGridColumn.Initialize().)
	InitializeCell	Inicializuje buňku představující tento sloupec s uzavřeného hypertextový odkaz. (Přepisuje DataGridColumn.InitializeCell(TableCell, Int32, ListItemType).)
	LoadViewState	Načte stav DataGridColumn objektu. (Zděděno z DataGridColumn.)
	MemberwiseClone	Vytvoří mělkou kopii aktuálního Object. (Zděděno z Object.)
	OnColumnChanged	Volá metodu DataGridDesigner.OnColumnsChanged. (Zděděno z DataGridColumn.)
	SaveViewState	Uloží aktuální stav DataGridColumn objektu. (Zděděno z DataGridColumn.)
	ToString	Vrací řetězcové vyjádření sloupce. (Zděděno z DataGridColumn.)
	TrackViewState	Způsobí, že sledování stavu zobrazení změn řízení serveru, mohou být uloženy v řízení serveru System.Web.UI.StateBag objektu. (Zděděno z DataGridColumn.)

Nahoru

Explicitní implementace rozhraní

	Název	Popis
	IStateManager.IsTrackingViewState	Infrastruktura. Získá hodnota, která určuje, zda je sloupec sledování změn stavu zobrazení. (Zděděno z DataGridColumn.)
	IStateManager.LoadViewState	Infrastruktura. Načte dříve uložené státem. (Zděděno z DataGridColumn.)
	IStateManager.SaveViewState	Infrastruktura. Vrátí objekt obsahující změny stavu. (Zděděno z DataGridColumn.)
	IStateManager.TrackViewState	Infrastruktura. Spuštění sledování změn stavu. (Zděděno z DataGridColumn.)

Nahoru

Poznámky

Použití HyperLinkColumn typ sloupce v DataGrid ovládací prvek vytvoříte hypertextový odkaz pro každý řádek v DataGrid. Nastavit Text vlastnost, aby text titulku pro hypertextový odkaz. Chcete-li propojit po klepnutí na hypertextový odkaz na adresu URL, nastavte NavigateUrl vlastnost.

Poznámka
Pokud nastavíte Text a NavigateUrl vlastnosti, všechny hypertextové odkazy ve sloupci budou sdílet stejnou titulek a URL.

Můžete také svázat text titulku a URL hypertextové odkazy v HyperLinkColumn na pole ve zdroji dat namísto nastavení Text a NavigateUrl vlastnosti. To umožňuje zobrazit různé titulek a zadejte jinou adresu URL pro každý hypertextový odkaz ve sloupci.

Použití DataTextField vlastnost, aby pole ve zdroji dat vytvořit vazbu na titulek textu hypertextových odkazů ve sloupci.

Poznámka
DataTextField a Text vlastnosti nemůže být nastavena obě současně. Pokud jsou obě vlastnosti nastavena DataTextField vlastnost přednost.

Zadat pole nastavením svázat URL hypertextového odkazu DataNavigateUrlField vlastnost.

Poznámka
DataNavigateUrlField a NavigateUrl vlastnosti nemůže být nastavena obě současně. Pokud jsou obě vlastnosti nastavena DataNavigateUrlField vlastnost přednost.

Target Vlastnost umožňuje určit okna nebo rámce pro zobrazení obsahu webové stránky při klepnutí na hypertextový odkaz propojen.

Při použití datové vazby nastavením můžete formátovat text titulku a URL hypertextového odkazu DataTextFormatString a DataNavigateUrlFormatString vlastnosti, resp..

Upozornění
Tento ovládací prvek slouží k zobrazení vstup uživatele může obsahovat klienta škodlivý skript. Zkontrolujte veškeré informace odeslané z klienta pro spustitelný soubor skriptu, příkazy SQL nebo jiný kód před zobrazením v aplikaci. Ovládací prvky pro ověření můžete ověřit vstup uživatele před zobrazením vstupního textu v ovládacím prvku. PROSTŘEDÍ ASP.NET nabízí funkci ověření požadavku vstupní blok skriptu a HTML v vstup uživatele. Další informace naleznete v tématu Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings a Introduction to Validating User Input in ASP.NET Web Pages.

Upozornění

Tento ovládací prvek slouží k zobrazení vstup uživatele může obsahovat klienta škodlivý skript. Zkontrolujte veškeré informace odeslané z klienta pro spustitelný soubor skriptu, příkazy SQL nebo jiný kód před zobrazením v aplikaci. Ovládací prvky pro ověření můžete ověřit vstup uživatele před zobrazením vstupního textu v ovládacím prvku. PROSTŘEDÍ ASP.NET nabízí funkci ověření požadavku vstupní blok skriptu a HTML v vstup uživatele. Další informace naleznete v tématu Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings a Introduction to Validating User Input in ASP.NET Web Pages.

Příklady

Následující příklad ukazuje, jak vytvořit HyperLinkColumn které odkazují na samostatné stránce.

Poznámka
Následující příklad kódu používá model jednoho souboru kód a nemusí fungovat správně, pokud je zkopírována do souboru s kódem na pozadí. Tento ukázkový kód musí být zkopírovány do prázdného textového souboru, který má příponu ASPX. Další informace o modelu kódu webových formulářů naleznete v ASP.NET Web 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>

Následující příklad odpovídající zobrazí položky vybrané 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>

Informace o verzi

.NET Framework

Podporováno v: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platformy

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (role Server Core není podporována), Windows Server 2008 R2 (role Server Core je podporována s aktualizací SP1 nebo novější, architektura Itanium není podporována)

.NET Framework nepodporuje některé verze platforem. Seznam podporovaných verzí naleznete v tématu Požadavky na systém rozhraní .NET framework.

Bezpečný přístup z více vláken

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.

Viz také