HyperLinkColumn Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein Spaltentyp für das DataGrid Steuerelement, das einen Link für jedes Element in der Spalte enthält.

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

Vererbung: Object

DataGridColumn
HyperLinkColumn

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie eine HyperLinkColumn Verknüpfung zu einer separaten Seite erstellen.

Hinweis

Im folgenden Codebeispiel wird das Codemodell mit einer Datei verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms 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>

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

Im folgenden entsprechenden Beispiel wird das im vorherigen Beispiel ausgewählte Element angezeigt.

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

Hinweise

Verwenden Sie den HyperLinkColumn Spaltentyp in einem DataGrid Steuerelement, um einen Link für jede Zeile in der .DataGrid Legen Sie die Text Eigenschaft fest, um den Beschriftungstext für den Link anzugeben. Wenn Sie die URL angeben möchten, mit der der Link verknüpft werden soll, wenn auf den Link geklickt wird, legen Sie die NavigateUrl Eigenschaft fest.

Hinweis

Wenn Sie die Eigenschaften und NavigateUrl die Text Eigenschaften festlegen, werden alle Links in der Spalte die gleiche Beschriftung und URL gemeinsam verwenden.

Sie können auch die Textbeschriftung und die URL der Hyperlinks in einem HyperLinkColumn Feld in einer Datenquelle binden, anstatt die Und-Eigenschaften NavigateUrl Text festzulegen. Auf diese Weise können Sie eine andere Beschriftung anzeigen und eine andere URL für jeden Link in der Spalte angeben.

Verwenden Sie die DataTextField Eigenschaft, um ein Feld in einer Datenquelle anzugeben, das an die Textbeschriftung der Hyperlinks in der Spalte gebunden werden soll.

Hinweis

Die DataTextField Eigenschaften können Text nicht gleichzeitig festgelegt werden. Wenn beide Eigenschaften festgelegt sind, hat die DataTextField Eigenschaft Vorrang.

Geben Sie das Feld an, das an die URL des Links gebunden werden soll, indem Sie die DataNavigateUrlField Eigenschaft festlegen.

Hinweis

Die DataNavigateUrlField Eigenschaften können NavigateUrl nicht gleichzeitig festgelegt werden. Wenn beide Eigenschaften festgelegt sind, hat die DataNavigateUrlField Eigenschaft Vorrang.

Mit der Target Eigenschaft können Sie das Fenster oder den Rahmen angeben, mit dem der Webseiteninhalt angezeigt werden soll, der beim Klicken auf den Link verknüpft ist.

Bei Verwendung der Datenbindung können Sie die Textbeschriftung und die URL des Links formatieren, indem Sie die Eigenschaften bzwDataNavigateUrlFormatString. eigenschaften DataTextFormatString festlegen.

Vorsicht

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die bösartige Clientskripts enthalten können. Überprüfen Sie alle Informationen, die von einem Client auf ausführbare Skripts, SQL-Anweisungen oder anderen Code gesendet werden, bevor Sie sie in Ihrer Anwendung anzeigen. Sie können Überprüfungssteuerelemente verwenden, um die Benutzereingabe zu überprüfen, bevor Sie den Eingabetext in einem Steuerelement anzeigen. ASP.NET stellt eine Eingabeanforderungsüberprüfungsfunktion bereit, um Skripts und HTML in der Benutzereingabe zu blockieren. Weitere Informationen finden Sie unter Sichern von Standardsteuerelementen, Vorgehensweise: Schutz vor Skript-Exploits in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Überprüfen von Benutzereingaben in ASP.NET Webseiten.

Konstruktoren

Name	Beschreibung
HyperLinkColumn()	Initialisiert eine neue Instanz der HyperLinkColumn-Klasse.

Eigenschaften

Name	Beschreibung
DataNavigateUrlField	Dient zum Abrufen oder Festlegen des Felds aus einer Datenquelle, um eine Bindung an die URL der Hyperlinks in der .HyperLinkColumn
DataNavigateUrlFormatString	Dient zum Abrufen oder Festlegen des Anzeigeformats für die URL der Hyperlinks, HyperLinkColumn wenn die URL an ein Feld in einer Datenquelle gebunden ist.
DataTextField	Dient zum Abrufen oder Festlegen des Felds aus einer Datenquelle, das an die Textbeschriftung der Hyperlinks in der .HyperLinkColumn
DataTextFormatString	Ruft ab oder legt das Anzeigeformat für die Textbeschriftung der Hyperlinks in der HyperLinkColumn Spalte fest.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet. (Geerbt von DataGridColumn)
FooterStyle	Ruft die Formatvorlageneigenschaften für den Fußzeilenabschnitt der Spalte ab. (Geerbt von DataGridColumn)
FooterText	Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenabschnitt der Spalte angezeigt wird. (Geerbt von DataGridColumn)
HeaderImageUrl	Dient zum Abrufen oder Festlegen der Position eines Bilds, das im Kopfzeilenabschnitt der Spalte angezeigt werden soll. (Geerbt von DataGridColumn)
HeaderStyle	Ruft die Formatvorlageneigenschaften für den Kopfzeilenabschnitt der Spalte ab. (Geerbt von DataGridColumn)
HeaderText	Dient zum Abrufen oder Festlegen des Texts, der im Kopfzeilenabschnitt der Spalte angezeigt wird. (Geerbt von DataGridColumn)
IsTrackingViewState	Ruft einen Wert ab, der bestimmt, ob das DataGridColumn Objekt zum Speichern des Zustands markiert ist. (Geerbt von DataGridColumn)
ItemStyle	Ruft die Formatvorlageneigenschaften für die Elementzellen der Spalte ab. (Geerbt von DataGridColumn)
NavigateUrl	Ruft die URL ab, mit der eine Verknüpfung hergestellt werden soll, wenn auf einen Link in der Spalte geklickt wird, oder legt diese fest.
Owner	Ruft das DataGrid Steuerelement ab, bei dem es sich bei der Spalte um ein Element handelt. (Geerbt von DataGridColumn)
SortExpression	Dient zum Abrufen oder Festlegen des Namens des Felds oder Ausdrucks, das an die Methode übergeben werden soll, wenn eine Spalte für die OnSortCommand(DataGridSortCommandEventArgs) Sortierung ausgewählt ist. (Geerbt von DataGridColumn)
Target	Ruft das Zielfenster oder den Zielrahmen ab, um den Webseiteninhalt anzuzeigen, der verknüpft ist, wenn auf den Link in der Spalte geklickt wird, oder legt diesen fest.
Text	Dient zum Abrufen oder Festlegen der Textbeschriftung, die für die Hyperlinks in der Spalte angezeigt werden soll.
ViewState	Ruft das StateBag Objekt ab, das eine von der DataGridColumn Klasse abgeleitete Spalte zum Speichern seiner Eigenschaften zulässt. (Geerbt von DataGridColumn)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Spalte im DataGrid Steuerelement sichtbar ist. (Geerbt von DataGridColumn)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
FormatDataNavigateUrlValue(Object)	Formatiert eine datengebundene URL mithilfe des durch die DataNavigateUrlFormatString Eigenschaft angegebenen Formats.
FormatDataTextValue(Object)	Formatiert eine datengebundene Textbeschriftung mithilfe des von der DataTextFormatString Eigenschaft angegebenen Formats.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize()	Stellt die Basisimplementierung bereit, um eine von der DataGridColumn Klasse abgeleitete Spalte auf den Anfangszustand zurückzusetzen.
InitializeCell(TableCell, Int32, ListItemType)	Initialisiert die Zelle, die diese Spalte mit dem enthaltenen Hyperlink darstellt.
LoadViewState(Object)	Lädt den Zustand des DataGridColumn Objekts. (Geerbt von DataGridColumn)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnColumnChanged()	Ruft die OnColumnsChanged() Methode auf. (Geerbt von DataGridColumn)
SaveViewState()	Speichert den aktuellen Zustand des DataGridColumn Objekts. (Geerbt von DataGridColumn)
ToString()	Gibt die Zeichenfolgendarstellung der Spalte zurück. (Geerbt von DataGridColumn)
TrackViewState()	Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können. (Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die Spalte Ansichtszustandsänderungen nachverfolgt. (Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand. (Geerbt von DataGridColumn)
IStateManager.SaveViewState()	Gibt ein Objekt zurück, das Zustandsänderungen enthält. (Geerbt von DataGridColumn)
IStateManager.TrackViewState()	Beginnt mit der Nachverfolgung von Zustandsänderungen. (Geerbt von DataGridColumn)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?

Freigeben über

HyperLinkColumn Klasse

Definition

Beispiele

Hinweise

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

Feedback