HyperLinkField Klasse
Definition
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.
Stellt ein Feld dar, das als Link in einem datengebundenen Steuerelement angezeigt wird.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein Objekt verwendet wird, um eine HyperLinkField Spalte statischer Hyperlinks in einem GridView Steuerelement anzuzeigen. Jeder Link in der HyperLinkField Proxyadresse dieses Objekts übereinstimmt, die gleiche Beschriftung und URL, die gemäß der Text und NavigateUrl Eigenschaften bzw.
<%@ Page language="C#" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Im folgenden Codebeispiel wird veranschaulicht, wie ein HyperLinkField Objekt an Felder in einer Datenquelle gebunden wird. DataNavigateUrlFields Die DataTextField Eigenschaften und Eigenschaften werden verwendet, um die Felder anzugeben, die an die Beschriftung und die Navigations-URL HyperLinkField gebunden werden sollen.
<%@ Page language="C#" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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 runat="server">
<title>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Hinweise
Die HyperLinkField Klasse wird von datengebundenen Steuerelementen (z GridView . B. und DetailsView) verwendet, um einen Link für jeden angezeigten Datensatz anzuzeigen. Wenn der Benutzer auf einen Link klickt, werden sie an die Webseite weitergeleitet, die dem Link zugeordnet ist. Das HyperLinkField Objekt wird je nach datengebundenem Steuerelement, in dem er verwendet wird, unterschiedlich angezeigt. Das Steuerelement zeigt beispielsweise ein HyperLinkField Objekt als Spalte an, während das GridView DetailsView Steuerelement es als Zeile anzeigt.
Um die beschriftung anzugeben, die für die Hyperlinks angezeigt werden soll, verwenden Sie die Text Eigenschaft. Verwenden Sie die NavigateUrl Eigenschaft, um die URL anzugeben, um zu navigieren, wenn ein Link geklickt wird. Wenn Sie den verknüpften Inhalt in einem bestimmten Fenster oder Rahmen anzeigen möchten, legen Sie die Target Eigenschaft fest.
Hinweis
Wenn die Text NavigateUrl Eigenschaften festgelegt werden, teilen alle Hyperlinks im HyperLinkField Objekt dieselbe Beschriftungs- und Navigations-URL. Ebenso gilt die Target Eigenschaft auch für alle Hyperlinks.
Alternativ können Sie das HyperLinkField Objekt an Felder in einer Datenquelle binden. Dadurch können Sie eine andere Beschriftung für jeden Link im HyperLinkField Objekt anzeigen und jeden Link an einem anderen Speicherort navigieren. Um ein Feld an eine Beschriftung zu binden, legen Sie die DataTextField Eigenschaft fest. Um eine URL für die Navigation zu erstellen, legen Sie die DataNavigateUrlFields Eigenschaft auf eine durch Komma getrennte Liste von Feldern fest, die zum Erstellen der URL verwendet werden sollen.
Geben Sie ein benutzerdefiniertes Format für die Beschriftungen und die URLs für die Navigation durch Festlegen der DataTextFormatString und DataNavigateUrlFormatString Eigenschaften bzw.
Sie können ein HyperLinkField Objekt in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible Eigenschaft auf falsefestlegen.
Sie können die Kopf- und Fußzeilenabschnitte eines HyperLinkField Objekts anpassen. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitte anzuzeigen, legen Sie die HeaderText oder FooterText Eigenschaften bzw. Um ein Bild im Kopfzeilenabschnitt anstelle von Text anzuzeigen, legen Sie die HeaderImageUrl Eigenschaft fest. Der Kopfzeilenabschnitt kann im HyperLinkField Objekt ausgeblendet werden, indem Sie die ShowHeader Eigenschaft auf falsefestlegen.
Hinweis
Einige datengebundene Steuerelemente (z. B. das GridView Steuerelement) können nur den gesamten Kopfzeilenabschnitt des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader Eigenschaft für ein einzelnes gebundenes Feld nicht. Um den gesamten Kopfzeilenabschnitt eines datengebundenen Steuerelements anzuzeigen oder auszublenden, verwenden Sie die Eigenschaft des Steuerelements ShowHeader (falls verfügbar).
Sie können auch die Darstellung des HyperLinkField Objekts anpassen (Schriftartfarbe, Hintergrundfarbe usw.), indem Sie die Formatvorlageneigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Formatvorlageneigenschaften aufgeführt.
| Style-Eigenschaft | BESCHREIBUNG |
|---|---|
| ControlStyle | Die Formatvorlageneinstellungen für die untergeordneten Webserversteuerelemente des HyperLinkField Objekts. |
| FooterStyle | Die Formatvorlageneinstellungen für den Fußzeilenabschnitt des HyperLinkField Objekts. |
| HeaderStyle | Die Formatvorlageneinstellungen für den Kopfzeilenabschnitt des HyperLinkField Objekts. |
| ItemStyle | Die Formatvorlageneinstellungen für die Datenelemente im HyperLinkField Objekt. |
Konstruktoren
| HyperLinkField() |
Initialisiert eine neue Instanz der HyperLinkField-Klasse. |
Eigenschaften
| AccessibleHeaderText |
Ruft Text ab, der in einigen Steuerelementen als |
| Control |
Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist. (Geerbt von DataControlField) |
| ControlStyle |
Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab. (Geerbt von DataControlField) |
| DataNavigateUrlFields |
Ruft die Namen der Felder aus der Datenquelle ab, mit deren Hilfe die URLs für die Links in dem HyperLinkField-Objekt erstellt werden, oder legt diese fest. |
| DataNavigateUrlFormatString |
Ruft die Zeichenfolge ab, die das Format angibt, in dem die URLs für die Links in einem HyperLinkField-Objekt gerendert werden, oder legt diese Zeichenfolge fest. |
| DataTextField |
Ruft den Namen des Felds aus der Datenquelle ab, das den Text enthält, der für die Linkbeschriftungen in dem HyperLinkField-Objekt angezeigt werden soll. |
| DataTextFormatString |
Ruft die Zeichenfolge ab, die das Format angibt, in dem die Linkbeschriftungen in einem HyperLinkField-Objekt angezeigt werden, oder legt diese Zeichenfolge fest. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField) |
| FooterStyle |
Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField) |
| FooterText |
Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest. (Geerbt von DataControlField) |
| HeaderImageUrl |
Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest. (Geerbt von DataControlField) |
| HeaderStyle |
Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField) |
| HeaderText |
Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest. (Geerbt von DataControlField) |
| InsertVisible |
Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField) |
| ItemStyle |
Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden. (Geerbt von DataControlField) |
| NavigateUrl |
Ruft die URL ab, zu der beim Klicken auf einen Link in einem HyperLinkField-Objekt navigiert wird, oder legt diese fest. |
| ShowHeader |
Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest. (Geerbt von DataControlField) |
| SortExpression |
Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest. (Geerbt von DataControlField) |
| Target |
Ruft das Zielfenster oder den Zielframe ab, in dem die verknüpfte Webseite beim Klicken auf einen Link in einem HyperLinkField-Objekt angezeigt werden soll, oder legt dieses Fenster bzw. diesen Frame fest. |
| Text |
Ruft den Text ab, der für jeden Link im HyperLinkField-Objekt angezeigt werden soll, oder legt diesen fest. |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft. (Geerbt von DataControlField) |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von DataControlField) |
| Visible |
Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest. (Geerbt von DataControlField) |
Methoden
| CloneField() |
Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts. (Geerbt von DataControlField) |
| CopyProperties(DataControlField) |
Kopiert die Eigenschaften des aktuellen HyperLinkField-Objekts in das angegebene Objekt. |
| CreateField() |
Gibt eine neue Instanz der HyperLinkField-Klasse zurück. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Extrahiert den Wert des Datensteuerelement-Felds aus der aktuellen Tabellenzelle und fügt den Wert der angegebenen IDictionary-Auflistung hinzu. (Geerbt von DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Formatiert die Navigations-URL mit der von der DataNavigateUrlFormatString-Eigenschaft angegebenen Formatzeichenfolge. |
| FormatDataTextValue(Object) |
Formatiert den Beschriftungstext mit der von der DataTextFormatString-Eigenschaft angegebenen Formatzeichenfolge. |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize(Boolean, Control) |
Initialisiert das HyperLinkField-Objekt. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Initialisiert eine Zelle in einem HyperLinkField-Objekt. |
| LoadViewState(Object) |
Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnFieldChanged() |
Löst das |
| SaveViewState() |
Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField) |
| ToString() |
Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt. (Geerbt von DataControlField) |
| TrackViewState() |
Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField) |
| ValidateSupportsCallback() |
Gibt an, dass die im HyperLinkField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen. |
Explizite Schnittstellenimplementierungen
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest. (Geerbt von DataControlField) |
| IStateManager.IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField) |
| IStateManager.LoadViewState(Object) |
Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her. (Geerbt von DataControlField) |
| IStateManager.SaveViewState() |
Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField) |
| IStateManager.TrackViewState() |
Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField) |