HyperLinkColumn Klasse

Definition

Ein Spaltentyp für das DataGrid-Steuerelement, das einen Link für jedes Element in der Spalte enthält.A column type for the DataGrid control that contains a hyperlink for each item in the column.

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 Sie eine HyperLinkColumn erstellen, die mit einer separaten Seite verknüpft ist.The following example demonstrates how to create a HyperLinkColumn that links to a separate page.

Hinweis

Im folgenden Codebeispiel wird das Einzel Datei-Code Modell verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine Code-Behind-Datei kopiert wird.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung ASPX kopiert werden.This code sample must be copied into an empty text file that has an .aspx extension. Weitere Informationen zum Web Forms-Code Modell finden Sie unter ASP.net Web Forms Page Code Model.For more information on the Web Forms code model, see 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.The following corresponding example displays the item selected in the previous example.

<%@ 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 Hyperlink für jede Zeile in der DataGridzu erstellen.Use the HyperLinkColumn column type in a DataGrid control to create a hyperlink for each row in the DataGrid. Legen Sie die Text-Eigenschaft fest, um den Beschriftungs Text für den Link anzugeben.Set the Text property to specify the caption text for the hyperlink. Um die URL anzugeben, zu der beim Klicken auf den Hyperlink eine Verknüpfung hergestellt werden soll, legen Sie die NavigateUrl-Eigenschaft festTo specify the URL to link to when the hyperlink is clicked, set the NavigateUrl property.

Hinweis

Wenn Sie die Eigenschaften Text und NavigateUrl festlegen, haben alle Hyperlinks in der Spalte dieselbe Beschriftung und URL.If you set the Text and NavigateUrl properties, all hyperlinks in the column will share the same caption and URL.

Sie können auch die Text Beschriftung und die URL der Links im HyperLinkColumn an ein Feld in einer Datenquelle binden, anstatt die Text-und NavigateUrl-Eigenschaften festzulegen.You can also bind the text caption and URL of the hyperlinks in the HyperLinkColumn to a field in a data source instead of setting the Text and NavigateUrl properties. Dies ermöglicht es Ihnen, eine andere Beschriftung anzuzeigen und eine andere URL für jeden Hyperlink in der Spalte anzugeben.This allows you to display a different caption and to specify a different URL for each hyperlink in the column.

Verwenden Sie die DataTextField-Eigenschaft, um ein Feld in einer Datenquelle anzugeben, das an den Beschriftungs Text der Links in der Spalte gebunden werden soll.Use the DataTextField property to specify a field in a data source to bind to the text caption of the hyperlinks in the column.

Hinweis

Die Eigenschaften "DataTextField" und "Text" können nicht gleichzeitig festgelegt werden.The DataTextField and Text properties cannot both be set at the same time. Wenn beide Eigenschaften festgelegt sind, hat die DataTextField-Eigenschaft Vorrang.If both properties are set, the DataTextField property takes precedence.

Geben Sie das Feld an, das an die URL des Links gebunden werden soll, indem Sie die DataNavigateUrlField-Eigenschaft festlegen.Specify the field to bind to the URL of the hyperlink by setting the DataNavigateUrlField property.

Hinweis

Die Eigenschaften "DataNavigateUrlField" und "NavigateUrl" können nicht gleichzeitig festgelegt werden.The DataNavigateUrlField and NavigateUrl properties cannot both be set at the same time. Wenn beide Eigenschaften festgelegt sind, hat die DataNavigateUrlField-Eigenschaft Vorrang.If both properties are set, the DataNavigateUrlField property takes precedence.

Die Target-Eigenschaft ermöglicht es Ihnen, das Fenster oder den Frame anzugeben, mit dem der Inhalt der Webseite angezeigt werden soll, mit dem der Link verknüpft ist.The Target property allows you to specify the window or frame to display the Web page content linked to when the hyperlink is clicked.

Wenn Sie die Datenbindung verwenden, Sie können die textbeschriftung und formatieren URL des Links durch Festlegen der DataTextFormatString und DataNavigateUrlFormatString Eigenschaften bzw.When using data binding, you can format the text caption and URL of the hyperlink by setting the DataTextFormatString and DataNavigateUrlFormatString properties, respectively.

Achtung

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Client Skripts enthalten.This control can be used to display user input, which might include malicious client script. Überprüfen Sie alle Informationen, die von einem Client für ausführbare Skripts, SQL-Anweisungen oder anderen Code gesendet werden, bevor Sie ihn in der Anwendung anzeigen.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. Sie können Validierungs Steuerelemente verwenden, um Benutzereingaben zu überprüfen, bevor Sie den Eingabetext in einem Steuerelement anzeigen.You can use validation controls to verify user input before displaying the input text in a control. ASP.net bietet eine Überprüfungs Funktion für die Eingabe Anforderung zum Blockieren von Skripts und HTML in Benutzereingaben.ASP.NET provides an input request validation feature to block script and HTML in user input. Weitere Informationen finden Sie unter Sichern von Standard Steuerelementen, Gewusst wie: schützen vor Skript Exploits in einer Webanwendung durch Anwenden der HTML-Codierung aufZeichen folgen und Validieren von Benutzereingaben in ASP.net Web Pages.For more information, see 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.

Konstruktoren

HyperLinkColumn()

Initialisiert eine neue Instanz der Klasse HyperLinkColumn.Initializes a new instance of the HyperLinkColumn class.

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.Gets or sets the field from a data source to bind to the URL of the hyperlinks in the HyperLinkColumn.

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.Gets or sets the display format for the URL of the hyperlinks in the HyperLinkColumn when the URL is data-bound to a field in a data source.

DataTextField

Ruft das Feld aus einer Datenquelle ab, das an den Beschriftungstext der Links in der HyperLinkColumn gebunden werden soll, oder legt dieses fest.Gets or sets the field from a data source to bind to the text caption of the hyperlinks in the HyperLinkColumn.

DataTextFormatString

Ruft das Anzeigeformat für den Beschriftungstext der Links in der HyperLinkColumn-Spalte ab oder legt dieses fest.Gets or sets the display format for the text caption of the hyperlinks in the HyperLinkColumn column.

DesignMode

Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet.Gets a value that indicates whether the column is in design mode.

(Geerbt von DataGridColumn)
FooterStyle

Ruft die Formatierungseigenschaften für den Fußzeilenbereich der Spalte ab.Gets the style properties for the footer section of the column.

(Geerbt von DataGridColumn)
FooterText

Ruft den im Fußzeilenbereich der Spalte angezeigten Text ab oder legt diesen fest.Gets or sets the text displayed in the footer section of the column.

(Geerbt von DataGridColumn)
HeaderImageUrl

Ruft den Speicherort eines Bilds ab, das im Headerbereich der Spalte angezeigt werden soll, oder legt diesen fest.Gets or sets the location of an image to display in the header section of the column.

(Geerbt von DataGridColumn)
HeaderStyle

Ruft die Formatierungseigenschaften für den Headerbereich der Spalte ab.Gets the style properties for the header section of the column.

(Geerbt von DataGridColumn)
HeaderText

Ruft den im Headerbereich der Spalte angezeigten Text ab oder legt diesen fest.Gets or sets the text displayed in the header section of the column.

(Geerbt von DataGridColumn)
IsTrackingViewState

Ruft einen Wert ab, der bestimmt, ob das DataGridColumn-Objekt markiert wird, um seinen Zustand zu speichern.Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Geerbt von DataGridColumn)
ItemStyle

Ruft die Formatierungseigenschaften für die einzelnen Zellen der Spalte ab.Gets the style properties for the item cells of the column.

(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.Gets or sets the URL to link to when a hyperlink in the column is clicked.

Owner

Ruft das DataGrid-Steuerelement ab, zu dessen Membern die Spalte gehört.Gets the DataGrid control that the column is a member of.

(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.Gets or sets the name of the field or expression to pass to the OnSortCommand(DataGridSortCommandEventArgs) method when a column is selected for sorting.

(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.Gets or sets the target window or frame to display the Web page content that is linked to when the hyperlink in the column is clicked.

Text

Ruft den für die Links in der Spalte anzuzeigenden Beschriftungstext ab oder legt diesen fest.Gets or sets the text caption to display for the hyperlinks in the column.

ViewState

Ruft das StateBag-Objekt ab, wodurch einer von der DataGridColumn-Klasse abgeleiteten Spalte ermöglicht wird, ihre Eigenschaften zu speichern.Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Geerbt von DataGridColumn)
Visible

Ruft einen Wert ab, der angibt, ob die Spalte im DataGrid-Steuerelement sichtbar ist, oder legt diesen fest.Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Geerbt von DataGridColumn)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FormatDataNavigateUrlValue(Object)

Formatiert eine datengebundene URL mit dem von der DataNavigateUrlFormatString-Eigenschaft angegebenen Format.Formats a data-bound URL using the format specified by the DataNavigateUrlFormatString property.

FormatDataTextValue(Object)

Formatiert einen datengebundenen Beschriftungstext mit dem von der DataTextFormatString-Eigenschaft angegebenen Format.Formats a data-bound text caption using the format specified by the DataTextFormatString property.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Initialize()

Stellt die Basisimplementierung bereit, mit der eine aus der DataGridColumn-Klasse abgeleitete Spalte in ihren Ausgangszustand zurückgesetzt werden kann.Provides the base implementation to reset a column derived from the DataGridColumn class to its initial state.

InitializeCell(TableCell, Int32, ListItemType)

Initialisiert die Zelle, die diese Spalte mit dem enthaltenen Link darstellt.Initializes the cell representing this column with the contained hyperlink.

LoadViewState(Object)

Lädt den Zustand des DataGridColumn-Objekts.Loads the state of the DataGridColumn object.

(Geerbt von DataGridColumn)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnColumnChanged()

Aufruf der OnColumnsChanged()-Methode.Calls the OnColumnsChanged() method.

(Geerbt von DataGridColumn)
SaveViewState()

Speichert den aktuellen Zustand des DataGridColumn-Objekts.Saves the current state of the DataGridColumn object.

(Geerbt von DataGridColumn)
ToString()

Gibt die Zeichenfolgendarstellung der Spalte zurück.Returns the string representation of the column.

(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.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object.

(Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob die Spalte Änderungen des Ansichtszustands nachverfolgt.Gets a value that indicates whether the column is tracking view state changes.

(Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)

Lädt den früher gespeicherten Zustand.Loads previously saved state.

(Geerbt von DataGridColumn)
IStateManager.SaveViewState()

Gibt ein Objekt zurück, das Zustandsänderungen enthält.Returns an object containing state changes.

(Geerbt von DataGridColumn)
IStateManager.TrackViewState()

Startet das Verfolgen von Zustandsänderungen.Starts tracking state changes.

(Geerbt von DataGridColumn)

Gilt für:

Siehe auch