HyperLinkColumn Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Een kolomtype voor het DataGrid besturingselement dat een hyperlink bevat voor elk item in de kolom.

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

Overname: Object

DataGridColumn
HyperLinkColumn

Voorbeelden

In het volgende voorbeeld ziet u hoe u een HyperLinkColumn koppeling maakt naar een afzonderlijke pagina.

Note

Het volgende codevoorbeeld maakt gebruik van het codemodel met één bestand en werkt mogelijk niet correct als deze rechtstreeks naar een codeachterstaand bestand wordt gekopieerd. Dit codevoorbeeld moet worden gekopieerd naar een leeg tekstbestand met een .aspx-extensie. Zie ASP.NET Web Forms Page Code Model voor meer informatie over het webformuliercodemodel.

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

In het volgende overeenkomstige voorbeeld wordt het item weergegeven dat in het vorige voorbeeld is geselecteerd.

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

Opmerkingen

Gebruik het HyperLinkColumn kolomtype in een DataGrid besturingselement om een hyperlink te maken voor elke rij in de DataGrid. Stel de Text eigenschap in om de bijschrifttekst voor de hyperlink op te geven. Als u de URL wilt opgeven waarnaar u een koppeling wilt maken wanneer op de hyperlink wordt geklikt, stelt u de NavigateUrl eigenschap in.

Note

Als u de Text en NavigateUrl eigenschappen instelt, delen alle hyperlinks in de kolom hetzelfde bijschrift en dezelfde URL.

U kunt ook het tekstbijschrift en de URL van de hyperlinks in het HyperLinkColumn veld in een gegevensbron binden in plaats van de Text en NavigateUrl eigenschappen in te stellen. Hiermee kunt u een ander bijschrift weergeven en een andere URL opgeven voor elke hyperlink in de kolom.

Gebruik de DataTextField eigenschap om een veld in een gegevensbron op te geven om verbinding te maken met het bijschrift van de hyperlinks in de kolom.

Note

De DataTextField eigenschappen en Text eigenschappen kunnen niet tegelijkertijd worden ingesteld. Als beide eigenschappen zijn ingesteld, heeft de DataTextField eigenschap voorrang.

Geef het veld op dat moet worden gekoppeld aan de URL van de hyperlink door de DataNavigateUrlField eigenschap in te stellen.

Note

De DataNavigateUrlField eigenschappen en NavigateUrl eigenschappen kunnen niet tegelijkertijd worden ingesteld. Als beide eigenschappen zijn ingesteld, heeft de DataNavigateUrlField eigenschap voorrang.

Met Target de eigenschap kunt u het venster of frame opgeven om de inhoud van de webpagina weer te geven die is gekoppeld wanneer op de hyperlink wordt geklikt.

Wanneer u gegevensbinding gebruikt, kunt u het bijschrift en de URL van de hyperlink opmaken door respectievelijk de DataTextFormatString en DataNavigateUrlFormatString eigenschappen in te stellen.

Caution

Dit besturingselement kan worden gebruikt om gebruikersinvoer weer te geven, waaronder mogelijk schadelijk clientscript. Controleer alle informatie die wordt verzonden vanaf een client voor uitvoerbaar script, SQL-instructies of andere code voordat u deze in uw toepassing weergeeft. U kunt validatiebesturingselementen gebruiken om gebruikersinvoer te controleren voordat u de invoertekst in een besturingselement weergeeft. ASP.NET biedt een validatiefunctie voor invoeraanvragen voor het blokkeren van scripts en HTML in gebruikersinvoer. Zie Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Validating User Input in ASP.NET Web Pages voor meer informatie.

Constructors

Name	Description
HyperLinkColumn()	Initialiseert een nieuw exemplaar van de HyperLinkColumn klasse.

Eigenschappen

Name	Description
DataNavigateUrlField	Hiermee haalt of stelt u het veld van een gegevensbron in om verbinding te maken met de URL van de hyperlinks in de HyperLinkColumn.
DataNavigateUrlFormatString	Hiermee haalt u de weergave-indeling op voor de URL van de hyperlinks in het HyperLinkColumn moment dat de URL is gebonden aan een veld in een gegevensbron.
DataTextField	Hiermee haalt u het veld van een gegevensbron op of stelt u het in om het tekstbijschrift van de hyperlinks in de HyperLinkColumnhyperlink te binden.
DataTextFormatString	Hiermee haalt u de weergave-indeling op voor het bijschrift van de hyperlinks in de HyperLinkColumn kolom.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of de kolom zich in de ontwerpmodus bevindt. (Overgenomen van DataGridColumn)
FooterStyle	Hiermee haalt u de stijleigenschappen voor de voettekstsectie van de kolom op. (Overgenomen van DataGridColumn)
FooterText	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven in de voettekstsectie van de kolom. (Overgenomen van DataGridColumn)
HeaderImageUrl	Hiermee wordt de locatie van een afbeelding opgehaald of ingesteld om weer te geven in de koptekstsectie van de kolom. (Overgenomen van DataGridColumn)
HeaderStyle	Hiermee haalt u de stijleigenschappen voor de koptekstsectie van de kolom op. (Overgenomen van DataGridColumn)
HeaderText	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven in de koptekstsectie van de kolom. (Overgenomen van DataGridColumn)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die bepaalt of het object is gemarkeerd om de DataGridColumn status op te slaan. (Overgenomen van DataGridColumn)
ItemStyle	Hiermee haalt u de stijleigenschappen voor de itemcellen van de kolom op. (Overgenomen van DataGridColumn)
NavigateUrl	Hiermee haalt u de URL op waarnaar u een koppeling wilt maken wanneer op een hyperlink in de kolom wordt geklikt.
Owner	Hiermee haalt u het DataGrid besturingselement op waarvan de kolom lid is. (Overgenomen van DataGridColumn)
SortExpression	Hiermee haalt u de naam van het veld of de expressie op die moet worden doorgegeven aan de OnSortCommand(DataGridSortCommandEventArgs) methode wanneer een kolom is geselecteerd voor sorteren. (Overgenomen van DataGridColumn)
Target	Hiermee wordt het doelvenster of het doelframe opgehaald of ingesteld om de inhoud van de webpagina weer te geven waaraan is gekoppeld wanneer op de hyperlink in de kolom wordt geklikt.
Text	Hiermee haalt u het bijschrift op of stelt u dit in om weer te geven voor de hyperlinks in de kolom.
ViewState	Hiermee haalt u het StateBag object op waarmee een kolom die is afgeleid van de DataGridColumn klasse, de eigenschappen ervan kan opslaan. (Overgenomen van DataGridColumn)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de kolom zichtbaar is in het DataGrid besturingselement. (Overgenomen van DataGridColumn)

Methoden

Name	Description
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FormatDataNavigateUrlValue(Object)	Hiermee wordt een gegevensgebonden URL opgemaakt met behulp van de indeling die is opgegeven door de DataNavigateUrlFormatString eigenschap.
FormatDataTextValue(Object)	Hiermee wordt een gegevensgebonden tekstbijschrift opgemaakt met behulp van de indeling die is opgegeven door de DataTextFormatString eigenschap.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Initialize()	Biedt de basis-implementatie voor het opnieuw instellen van een kolom die is afgeleid van de klasse in de DataGridColumn oorspronkelijke status.
InitializeCell(TableCell, Int32, ListItemType)	Initialiseert de cel die deze kolom vertegenwoordigt met de ingesloten hyperlink.
LoadViewState(Object)	Laadt de status van het DataGridColumn object. (Overgenomen van DataGridColumn)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnColumnChanged()	Roept de OnColumnsChanged() methode aan. (Overgenomen van DataGridColumn)
SaveViewState()	Hiermee wordt de huidige status van het DataGridColumn object opgeslagen. (Overgenomen van DataGridColumn)
ToString()	Retourneert de tekenreeksweergave van de kolom. (Overgenomen van DataGridColumn)
TrackViewState()	Veroorzaakt het bijhouden van wijzigingen in de weergavestatus in het serverbesturingselement, zodat deze kunnen worden opgeslagen in het object van StateBag het serverbesturingselement. (Overgenomen van DataGridColumn)

Expliciete interface-implementaties

Name	Description
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of de kolom de status van de weergave bijhoudt. (Overgenomen van DataGridColumn)
IStateManager.LoadViewState(Object)	Laadt eerder opgeslagen status. (Overgenomen van DataGridColumn)
IStateManager.SaveViewState()	Retourneert een object met statuswijzigingen. (Overgenomen van DataGridColumn)
IStateManager.TrackViewState()	Hiermee worden statuswijzigingen bijgehouden. (Overgenomen van DataGridColumn)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?