HyperLinkColumn Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A vezérlőelem oszloptípusa DataGrid , amely az oszlop minden eleméhez tartalmaz hivatkozást.

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

Öröklődés: Object

DataGridColumn
HyperLinkColumn

Példák

Az alábbi példa bemutatja, hogyan hozhat létre egy HyperLinkColumn külön lapra mutató hivatkozásokat.

Note

Az alábbi kódminta az egyfájlos kódmodellt használja, és előfordulhat, hogy nem működik megfelelően, ha közvetlenül egy kód mögötti fájlba másolja. Ezt a kódmintát egy üres szövegfájlba kell másolni, amely .aspx kiterjesztéssel rendelkezik. A Webes űrlapok kódmodellről további információt a ASP.NET Web Forms Lapkódmodell című témakörben talál.

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

Az alábbi megfelelő példa az előző példában kijelölt elemet jeleníti meg.

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

Megjegyzések

HyperLinkColumn A vezérlőelemek DataGrid oszloptípusával hozzon létre hivatkozást a DataGridvezérlőelem minden egyes sorához. Állítsa be a tulajdonságot Text a hivatkozás feliratszövegének megadásához. A hivatkozás kattintáskor hivatkozni kívánt URL-cím megadásához állítsa be a tulajdonságot NavigateUrl .

Note

Ha beállítja a tulajdonságokat és Text a NavigateUrl tulajdonságokat, az oszlop összes hivatkozása ugyanazt a feliratot és URL-címet fogja megosztani.

A hivatkozások HyperLinkColumn szöveges feliratát és URL-címét az adatforrás mezőihez is kötheti ahelyett, hogy a tulajdonságokat és Text a NavigateUrl tulajdonságokat állítanál be. Ez lehetővé teszi, hogy egy másik feliratot jelenítsen meg, és egy másik URL-címet adjon meg az oszlopban lévő hivatkozásokhoz.

DataTextField A tulajdonsággal megadhat egy mezőt egy adatforrásban, amely az oszlopban lévő hivatkozások szöveges feliratához kapcsolódik.

Note

A DataTextField tulajdonságok és Text a tulajdonságok nem állíthatók be egyszerre. Ha mindkét tulajdonság be van állítva, a DataTextField tulajdonság elsőbbséget élvez.

A tulajdonság beállításával DataNavigateUrlField adja meg azt a mezőt, amelyet a hivatkozás URL-címéhez szeretne kötni.

Note

A DataNavigateUrlField tulajdonságok és NavigateUrl a tulajdonságok nem állíthatók be egyszerre. Ha mindkét tulajdonság be van állítva, a DataNavigateUrlField tulajdonság elsőbbséget élvez.

A Target tulajdonság lehetővé teszi annak az ablaknak vagy keretnek a megadását, amellyel megjeleníthető a hivatkozás kattintásakor csatolt weblaptartalom.

Adatkötés használatakor formázhatja a hivatkozás szöveges feliratát és URL-címét a tulajdonságok és DataTextFormatString a DataNavigateUrlFormatString tulajdonságok beállításával.

Figyelmeztetés

Ez a vezérlő a felhasználói bemenetek megjelenítésére használható, amelyek rosszindulatú ügyfélszkripteket is tartalmazhatnak. Mielőtt megjelenítené az alkalmazásban, ellenőrizze az ügyféltől a végrehajtható szkriptekhez, SQL-utasításokhoz vagy más kódhoz küldött információkat. Érvényesítési vezérlőkkel ellenőrizheti a felhasználói bemenetet, mielőtt megjelenítené a beviteli szöveget egy vezérlőben. ASP.NET a bemeneti kérések érvényesítési funkciójával letilthatja a szkriptet és a HTML-t a felhasználói bemenetben. További információ: A standard vezérlők, Hogyan: Védelem a szkriptek kihasználása ellen a webalkalmazásokban a HTML-kódolás sztringekre való alkalmazásával és Az ASP.NET weblapok felhasználói bemenetének ellenőrzése.

Konstruktorok

Name	Description
HyperLinkColumn()	Inicializálja a HyperLinkColumn osztály új példányát.

Tulajdonságok

Name	Description
DataNavigateUrlField	Lekéri vagy beállítja a mezőt egy adatforrásból a hivatkozás URL-címéhez való kötéshez.HyperLinkColumn
DataNavigateUrlFormatString	Lekéri vagy beállítja a hivatkozások URL-címének megjelenítési formátumát abban az HyperLinkColumn esetben, amikor az URL-cím egy adatforrás egy mezőjéhez van kötve.
DataTextField	Lekéri vagy beállítja a mezőt egy adatforrásból, hogy a hivatkozás szövegfeliratához kössön kötést a HyperLinkColumn.
DataTextFormatString	Lekéri vagy beállítja az oszlopban lévő hivatkozások szöveges feliratának megjelenítési formátumát HyperLinkColumn .
DesignMode	Olyan értéket kap, amely jelzi, hogy az oszlop tervező módban van-e. (Öröklődés forrása DataGridColumn)
FooterStyle	Lekéri az oszlop láblécszakaszának stílustulajdonságait. (Öröklődés forrása DataGridColumn)
FooterText	Lekéri vagy beállítja az oszlop láblécszakaszában megjelenő szöveget. (Öröklődés forrása DataGridColumn)
HeaderImageUrl	Lekéri vagy beállítja egy kép helyét, hogy megjelenjen az oszlop fejlécszakaszában. (Öröklődés forrása DataGridColumn)
HeaderStyle	Lekéri az oszlop fejlécszakaszának stílustulajdonságait. (Öröklődés forrása DataGridColumn)
HeaderText	Lekéri vagy beállítja az oszlop fejlécszakaszában megjelenő szöveget. (Öröklődés forrása DataGridColumn)
IsTrackingViewState	Olyan értéket kap, amely meghatározza, hogy az DataGridColumn objektum meg van-e jelölve az állapot mentéséhez. (Öröklődés forrása DataGridColumn)
ItemStyle	Lekéri az oszlop elemcelláinak stílustulajdonságait. (Öröklődés forrása DataGridColumn)
NavigateUrl	Lekéri vagy beállítja a hivatkozás url-címét, amikor az oszlopban lévő hivatkozásra kattint.
Owner	Lekéri azt a DataGrid vezérlőt, amelynek az oszlop tagja. (Öröklődés forrása DataGridColumn)
SortExpression	Lekéri vagy beállítja annak a mezőnek vagy kifejezésnek a nevét, amely a rendezéshez kijelölt oszlopot adja át a OnSortCommand(DataGridSortCommandEventArgs) metódusnak. (Öröklődés forrása DataGridColumn)
Target	Lekéri vagy beállítja a célablakot vagy a keretet, hogy megjelenítse a hivatkozott weblap tartalmát, amikor az oszlopban lévő hivatkozásra kattint.
Text	Lekéri vagy beállítja a szöveges feliratot az oszlopban lévő hivatkozások megjelenítéséhez.
ViewState	Lekéri azt az StateBag objektumot, amely lehetővé teszi, hogy az DataGridColumn osztályból származó oszlop tárolja a tulajdonságait. (Öröklődés forrása DataGridColumn)
Visible	Lekéri vagy beállít egy értéket, amely jelzi, hogy az oszlop látható-e a DataGrid vezérlőben. (Öröklődés forrása DataGridColumn)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
FormatDataNavigateUrlValue(Object)	Adathoz kötött URL-cím formázása a DataNavigateUrlFormatString tulajdonság által megadott formátummal.
FormatDataTextValue(Object)	Adathoz kötött szöveges felirat formázása a DataTextFormatString tulajdonság által megadott formátummal.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Initialize()	Az alap implementációt biztosítja az osztályból DataGridColumn származó oszlop kezdeti állapotba állításához.
InitializeCell(TableCell, Int32, ListItemType)	Inicializálja az oszlopot képviselő cellát a tartalmazott hivatkozással.
LoadViewState(Object)	Betölti DataGridColumn az objektum állapotát. (Öröklődés forrása DataGridColumn)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnColumnChanged()	Meghívja a OnColumnsChanged() metódust. (Öröklődés forrása DataGridColumn)
SaveViewState()	Menti az objektum aktuális állapotát DataGridColumn . (Öröklődés forrása DataGridColumn)
ToString()	Az oszlop sztring-ábrázolását adja vissza. (Öröklődés forrása DataGridColumn)
TrackViewState()	A kiszolgálóvezérlő nézetállapot-változásainak nyomon követését okozza, hogy azok a kiszolgálóvezérlő StateBag objektumában tárolhatók legyenek. (Öröklődés forrása DataGridColumn)

Explicit interfész-implementációk

Name	Description
IStateManager.IsTrackingViewState	Olyan értéket kap, amely jelzi, hogy az oszlop nyomon követi-e a nézet állapotának változásait. (Öröklődés forrása DataGridColumn)
IStateManager.LoadViewState(Object)	Betölti a korábban mentett állapotot. (Öröklődés forrása DataGridColumn)
IStateManager.SaveViewState()	Állapotváltozásokat tartalmazó objektumot ad vissza. (Öröklődés forrása DataGridColumn)
IStateManager.TrackViewState()	Megkezdi az állapotváltozások nyomon követését. (Öröklődés forrása DataGridColumn)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?