HyperLinkColumn HyperLinkColumn HyperLinkColumn HyperLinkColumn Class

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
HyperLinkColumnHyperLinkColumnHyperLinkColumnHyperLinkColumn

Beispiele

Im folgende Beispiel wird veranschaulicht, wie zum Erstellen einer HyperLinkColumn mit einem Link zu einer separaten Seite.The following example demonstrates how to create a HyperLinkColumn that links to a separate page.

Hinweis

Im folgenden Codebeispiel wird das Codemodell von Einzeldatei-verwendet und möglicherweise nicht ordnungsgemäß ausgeführt werden, wenn direkt in einer Code-Behind-Datei kopiert.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. In diesem Codebeispiel wird, muss in eine leere Textdatei kopiert werden, die einer ASPX-Erweiterung.This code sample must be copied into an empty text file that has an .aspx extension. Weitere Informationen zu den Web Forms-Codemodell, finden Sie unter ASP.NET Web Forms-Seite-Codemodell.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 folgende entsprechenden Beispiel zeigt das Element, das im vorherigen Beispiel ausgewählt.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 der HyperLinkColumn Spaltentyp in einer DataGrid Steuerelement so erstellen Sie einen Link für jede Zeile in der DataGrid.Use the HyperLinkColumn column type in a DataGrid control to create a hyperlink for each row in the DataGrid. Legen Sie die Text -Eigenschaft an den Beschriftungstext für den Link.Set the Text property to specify the caption text for the hyperlink. Die URL zu, wenn auf den Link geklickt wird, legen die NavigateUrl Eigenschaft.To specify the URL to link to when the hyperlink is clicked, set the NavigateUrl property.

Hinweis

Setzen Sie die Text und NavigateUrl Eigenschaften, die alle Links in der Spalte werden die gleiche Beschriftung und URL freigeben.If you set the Text and NavigateUrl properties, all hyperlinks in the column will share the same caption and URL.

Sie können auch binden den Beschriftungstext und die URL der Links in der HyperLinkColumn auf ein Feld in einer Datenquelle, statt die Text und NavigateUrl Eigenschaften.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. Dadurch können Sie eine andere Beschriftung anzeigen und eine andere URL für jeden Link 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 der DataTextField Eigenschaft, um ein Feld in einer Datenquelle zum Binden an den Beschriftungstext der Links in der Spalte anzugeben.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 DataTextField und Text Eigenschaften können nicht beide zur gleichen Zeit festgelegt werden.The DataTextField and Text properties cannot both be set at the same time. Wenn beide Eigenschaften festgelegt werden, die DataTextField Eigenschaft austauschverarbeitungsmodi Vorrang vor.If both properties are set, the DataTextField property takes precedence.

Geben Sie das Feld zum Binden an die URL des Links durch Festlegen der DataNavigateUrlField Eigenschaft.Specify the field to bind to the URL of the hyperlink by setting the DataNavigateUrlField property.

Hinweis

Die DataNavigateUrlField und NavigateUrl Eigenschaften können nicht beide zur gleichen Zeit festgelegt werden.The DataNavigateUrlField and NavigateUrl properties cannot both be set at the same time. Wenn beide Eigenschaften festgelegt werden, die DataNavigateUrlField Eigenschaft austauschverarbeitungsmodi Vorrang vor.If both properties are set, the DataNavigateUrlField property takes precedence.

Die Target Eigenschaft können Sie angeben, das Fenster oder den Zielframe zum Anzeigen der Inhalt der Webseite mit verknüpft werden, wenn auf der Link geklickt wird.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 verwendet werden, zum Anzeigen von Benutzereingaben, u. u. bösartige Clientskripts enthalten können.This control can be used to display user input, which might include malicious client script. Überprüfen Sie alle Informationen, die für das ausführbare Skript, SQL-Anweisungen oder anderen Code von einem Client gesendet wird, vor der Anzeige in Ihrer Anwendung.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 Steuerelemente zur gültigkeitsprüfung verwenden, um Benutzereingaben zu überprüfen, bevor der Eingabetext in einem Steuerelement angezeigt.You can use validation controls to verify user input before displaying the input text in a control. ASP.NET bietet eine Funktion für den Überprüfung eingabeanforderung blockskript und HTML in einer Benutzereingabe.ASP.NET provides an input request validation feature to block script and HTML in user input. Weitere Informationen finden Sie unter Standardsteuerelemente Sichern, Vorgehensweise: Schutz vor Skriptangriffen in einer Webanwendung durch Anwenden von HTML-Codierung in Zeichenfolgen, und Überprüfen der Benutzereingabe in ASP.NET-Webseiten.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() HyperLinkColumn() HyperLinkColumn() HyperLinkColumn()

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

Eigenschaften

DataNavigateUrlField DataNavigateUrlField DataNavigateUrlField 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 DataNavigateUrlFormatString DataNavigateUrlFormatString 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 DataTextField DataTextField 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 DataTextFormatString DataTextFormatString 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 DesignMode DesignMode 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.

(Inherited from DataGridColumn)
FooterStyle FooterStyle FooterStyle FooterStyle

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

(Inherited from DataGridColumn)
FooterText FooterText FooterText 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.

(Inherited from DataGridColumn)
HeaderImageUrl HeaderImageUrl HeaderImageUrl 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.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

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

(Inherited from DataGridColumn)
HeaderText HeaderText HeaderText 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.

(Inherited from DataGridColumn)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState 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.

(Inherited from DataGridColumn)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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.

(Inherited from DataGridColumn)
ItemStyle ItemStyle ItemStyle ItemStyle

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

(Inherited from DataGridColumn)
NavigateUrl NavigateUrl NavigateUrl 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 Owner Owner Owner

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

(Inherited from DataGridColumn)
SortExpression SortExpression SortExpression 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.

(Inherited from DataGridColumn)
Target Target Target 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 Text Text 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 ViewState ViewState 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.

(Inherited from DataGridColumn)
Visible Visible Visible 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.

(Inherited from DataGridColumn)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FormatDataNavigateUrlValue(Object) FormatDataNavigateUrlValue(Object) FormatDataNavigateUrlValue(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) FormatDataTextValue(Object) FormatDataTextValue(Object) 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() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
Initialize() Initialize() Initialize() 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) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) 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) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

(Inherited from DataGridColumn)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnColumnChanged() OnColumnChanged() OnColumnChanged() OnColumnChanged()

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

(Inherited from DataGridColumn)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

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

(Inherited from DataGridColumn)
ToString() ToString() ToString() ToString()

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

(Inherited from DataGridColumn)
TrackViewState() TrackViewState() TrackViewState() 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.

(Inherited from DataGridColumn)

Explizite Schnittstellenimplementierungen

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

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

(Inherited from DataGridColumn)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

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

(Inherited from DataGridColumn)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

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

(Inherited from DataGridColumn)

Gilt für:

Siehe auch