HyperLinkColumn Klasse

Referenz

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 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:

Freigeben über

HyperLinkColumn Klasse

Definition

Beispiele

Hinweise

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

Zusätzliche Ressourcen