HyperLinkColumn Klasse

Definition

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
HyperLinkColumn

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine HyperLinkColumn erstellt wird, die mit einer separaten Seite verknüpft ist.

Hinweis

Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer .aspx-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms-Seitencodemodell.

<%@ 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 im DataGridzu erstellen. Legen Sie die Text -Eigenschaft fest, um den Beschriftungstext für den Link anzugeben. Legen Sie die -Eigenschaft fest, um die URL anzugeben, mit der beim Klicken auf den NavigateUrl Link verknüpft werden soll.

Hinweis

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

Sie können auch die Textbeschriftung und die URL der Hyperlinks in der HyperLinkColumn an ein Feld in einer Datenquelle binden, anstatt die Text Eigenschaften und NavigateUrl festzulegen. Dadurch können Sie eine andere Beschriftung anzeigen und für jeden Link in der Spalte eine andere URL angeben.

Verwenden Sie die DataTextField -Eigenschaft, um ein Feld in einer Datenquelle anzugeben, um an die Textbeschriftung der Hyperlinks in der Spalte zu binden.

Hinweis

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

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

Hinweis

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

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

Wenn Sie die Datenbindung verwenden, Sie können die textbeschriftung und formatieren URL des Links durch Festlegen der DataTextFormatString und DataNavigateUrlFormatString Eigenschaften bzw.

Achtung

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die möglicherweise schädliche Clientskripts enthalten. Ü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 Validierungssteuerelemente verwenden, um die Benutzereingabe zu überprüfen, bevor der Eingabetext in einem Steuerelement angezeigt wird. ASP.NET bietet eine Funktion zur Überprüfung von Eingabeanforderungen zum Blockieren von Skripts und HTML in Benutzereingaben. 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

HyperLinkColumn()

Initialisiert eine neue Instanz der HyperLinkColumn-Klasse.

Eigenschaften

DataNavigateUrlField

Ruft das Feld aus einer Datenquelle ab, das an die URL der Links in der HyperLinkColumn gebunden werden soll, oder legt dieses fest.

DataNavigateUrlFormatString

Ruft das Anzeigeformat für die URL der Links in der HyperLinkColumn ab, wenn für die URL eine Datenbindung an ein Feld in einer Datenquelle besteht, oder legt dieses fest.

DataTextField

Ruft das Feld aus einer Datenquelle ab, das an den Beschriftungstext der Links in der HyperLinkColumn gebunden werden soll, oder legt dieses fest.

DataTextFormatString

Ruft das Anzeigeformat für den Beschriftungstext der Links in der HyperLinkColumn-Spalte ab oder legt dieses fest.

DesignMode

Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet.

(Geerbt von DataGridColumn)
FooterStyle

Ruft die Formatierungseigenschaften für den Fußzeilenbereich der Spalte ab.

(Geerbt von DataGridColumn)
FooterText

Ruft den im Fußzeilenbereich der Spalte angezeigten Text ab oder legt diesen fest.

(Geerbt von DataGridColumn)
HeaderImageUrl

Ruft den Speicherort eines Bilds ab, das im Headerbereich der Spalte angezeigt werden soll, oder legt diesen fest.

(Geerbt von DataGridColumn)
HeaderStyle

Ruft die Formatierungseigenschaften für den Headerbereich der Spalte ab.

(Geerbt von DataGridColumn)
HeaderText

Ruft den im Headerbereich der Spalte angezeigten Text ab oder legt diesen fest.

(Geerbt von DataGridColumn)
IsTrackingViewState

Ruft einen Wert ab, der bestimmt, ob das DataGridColumn-Objekt markiert wird, um seinen Zustand zu speichern.

(Geerbt von DataGridColumn)
ItemStyle

Ruft die Formatierungseigenschaften für die einzelnen Zellen der Spalte ab.

(Geerbt von DataGridColumn)
NavigateUrl

Ruft die URL ab, die beim Klicken auf den Link in der Spalte geöffnet werden soll, oder legt diese fest.

Owner

Ruft das DataGrid-Steuerelement ab, zu dessen Membern die Spalte gehört.

(Geerbt von DataGridColumn)
SortExpression

Ruft den Namen des Felds oder Ausdrucks ab, der an die OnSortCommand(DataGridSortCommandEventArgs)-Methode übergeben wird, wenn eine Spalte für die Sortierung ausgewählt wurde, oder legt diesen fest.

(Geerbt von DataGridColumn)
Target

Ruft das Zielfenster oder den Zielframe ab, in dem der Inhalt der verknüpften Webseite dargestellt werden soll, wenn auf den Link in der Spalte geklickt wird, oder legt dieses bzw. diesen fest.

Text

Ruft den für die Links in der Spalte anzuzeigenden Beschriftungstext ab oder legt diesen fest.

ViewState

Ruft das StateBag-Objekt ab, wodurch einer von der DataGridColumn-Klasse abgeleiteten Spalte ermöglicht wird, ihre Eigenschaften zu speichern.

(Geerbt von DataGridColumn)
Visible

Ruft einen Wert ab, der angibt, ob die Spalte im DataGrid-Steuerelement sichtbar ist, oder legt diesen fest.

(Geerbt von DataGridColumn)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FormatDataNavigateUrlValue(Object)

Formatiert eine datengebundene URL mit dem von der DataNavigateUrlFormatString-Eigenschaft angegebenen Format.

FormatDataTextValue(Object)

Formatiert einen datengebundenen Beschriftungstext mit dem von der DataTextFormatString-Eigenschaft angegebenen Format.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize()

Stellt die Basisimplementierung bereit, mit der eine aus der DataGridColumn-Klasse abgeleitete Spalte in ihren Ausgangszustand zurückgesetzt werden kann.

InitializeCell(TableCell, Int32, ListItemType)

Initialisiert die Zelle, die diese Spalte mit dem enthaltenen Link darstellt.

LoadViewState(Object)

Lädt den Zustand des DataGridColumn-Objekts.

(Geerbt von DataGridColumn)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnColumnChanged()

Aufruf der OnColumnsChanged()-Methode.

(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()

Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können.

(Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob die Spalte Änderungen des Ansichtszustands nachverfolgt.

(Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)

Lädt den früher gespeicherten Zustand.

(Geerbt von DataGridColumn)
IStateManager.SaveViewState()

Gibt ein Objekt zurück, das Zustandsänderungen enthält.

(Geerbt von DataGridColumn)
IStateManager.TrackViewState()

Startet das Verfolgen von Zustandsänderungen.

(Geerbt von DataGridColumn)

Gilt für:

Weitere Informationen