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 Hyperlink 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 HyperLinkField Objekt zum Anzeigen einer Spalte statischer Hyperlinks in einem GridView Steuerelement verwendet wird. Jeder Hyperlink im HyperLinkField Objekt verwendet die gleiche Beschriftungs- und Navigations-URL, die bzw. die TextNavigateUrl eigenschaften angegeben sind.
<%@ 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. Mit DataTextField den Eigenschaften werden die Felder angegeben, die an die Beschriftung gebunden werden sollen, bzw. die Navigations-URL jedes Links, der HyperLinkField im Objekt angezeigt DataNavigateUrlFields wird.
<%@ 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, wird er an die Webseite weitergeleitet, die dem Link zugeordnet ist. Das HyperLinkField Objekt wird je nach dem datengebundenen Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Beispielsweise zeigt das GridView Steuerelement ein HyperLinkField Objekt als Spalte an, während das DetailsView Steuerelement es als Zeile anzeigt.
Verwenden Sie die Text Eigenschaft, um die für die Hyperlinks anzuzeigende Beschriftung anzugeben. Verwenden Sie die NavigateUrl Eigenschaft, um die URL anzugeben, zu der navigiert werden soll, wenn auf einen Link geklickt wird. Wenn Sie den verknüpften Inhalt in einem bestimmten Fenster oder Frame anzeigen möchten, legen Sie die Target Eigenschaft fest.
Hinweis
Wenn die Text Eigenschaften festgelegt NavigateUrl sind, verwenden 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. Auf diese Weise können Sie für jeden Link im HyperLinkField Objekt eine andere Beschriftung anzeigen und jeden Link an einer anderen Position navigieren lassen. 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 Trennzeichen getrennte Liste von Feldern fest, die zum Erstellen der URL verwendet werden sollen.
Sie können ein benutzerdefiniertes Format für die Beschriftungen und Navigations-URLs angeben, indem Sie die BzwDataNavigateUrlFormatString. die DataTextFormatString Eigenschaften festlegen.
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. Wenn Sie eine Beschriftung in den Kopf- oder Fußzeilenabschnitten anzeigen möchten, legen Sie die bzwFooterText. die HeaderText Eigenschaften fest. Wenn Sie ein Bild im Kopfzeilenabschnitt anstelle von Text anzeigen möchten, legen Sie die HeaderImageUrl Eigenschaft fest. Der Kopfzeilenabschnitt kann im HyperLinkField Objekt ausgeblendet werden, indem die ShowHeader Eigenschaft auf false.
Hinweis
Einige datengebundene Steuerelemente (z. B. das GridView Steuerelement) können nur den gesamten Kopfzeilenabschnitt des Steuerelements ein- oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader Eigenschaft für ein einzelnes gebundenes Feld nicht. Wenn Sie den gesamten Kopfzeilenabschnitt eines datengebundenen Steuerelements ein- oder ausblenden möchten, verwenden Sie die Eigenschaft des Steuerelements ShowHeader (sofern verfügbar).
Sie können auch die Darstellung des HyperLinkField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Formateigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Formateigenschaften 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
| Name | Beschreibung |
|---|---|
| HyperLinkField() |
Initialisiert eine neue Instanz der HyperLinkField-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessibleHeaderText |
Dient zum Abrufen oder Festlegen von Text, der |
| Control |
Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField Objekt zugeordnet ist. (Geerbt von DataControlField) |
| ControlStyle |
Ruft den Stil aller Webserversteuerelemente ab, die im DataControlField Objekt enthalten sind. (Geerbt von DataControlField) |
| DataNavigateUrlFields |
Dient zum Abrufen oder Festlegen der Namen der Felder aus der Datenquelle, die zum Erstellen der URLs für die Hyperlinks im HyperLinkField Objekt verwendet werden. |
| DataNavigateUrlFormatString |
Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Format angibt, in dem die URLs für die Hyperlinks in einem HyperLinkField Objekt gerendert werden. |
| DataTextField |
Dient zum Abrufen oder Festlegen des Namens des Felds aus der Datenquelle, das den Text enthält, der für die Hyperlinkbeschriftungen im HyperLinkField Objekt angezeigt werden soll. |
| DataTextFormatString |
Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Format angibt, in dem die Hyperlinkbeschriftungen in einem HyperLinkField Objekt angezeigt werden. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Datensteuerelementfeld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField) |
| FooterStyle |
Dient zum Abrufen oder Festlegen der Formatvorlage der Fußzeile des Datensteuerelementfelds. (Geerbt von DataControlField) |
| FooterText |
Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField) |
| HeaderImageUrl |
Dient zum Abrufen oder Festlegen der URL eines Bilds, das im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField) |
| HeaderStyle |
Dient zum Abrufen oder Festlegen des Stils der Kopfzeile des Datensteuerelementfelds. (Geerbt von DataControlField) |
| HeaderText |
Dient zum Abrufen oder Festlegen des Texts, der im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField) |
| InsertVisible |
Ruft einen Wert ab, der angibt, ob das DataControlField Objekt sichtbar ist, wenn sich das übergeordnete datengebundene Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField) |
| ItemStyle |
Ruft das Format aller textbasierten Inhalte ab, die von einem Datensteuerelementfeld angezeigt werden. (Geerbt von DataControlField) |
| NavigateUrl |
Ruft die URL ab, zu der navigiert werden soll, wenn auf einen Link in einem HyperLinkField Objekt geklickt wird, oder legt sie fest. |
| ShowHeader |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kopfzeilenelement eines Datensteuerelementfelds gerendert wird. (Geerbt von DataControlField) |
| SortExpression |
Dient zum Abrufen oder Festlegen eines Sortierausdrucks, der von einem Datenquellensteuerelement zum Sortieren von Daten verwendet wird. (Geerbt von DataControlField) |
| Target |
Ruft das Zielfenster oder den Zielrahmen ab, in dem die Webseite angezeigt werden soll, die verknüpft ist, wenn auf einen Link in einem HyperLinkField Objekt geklickt wird, oder legt diesen fest. |
| Text |
Ruft den Text ab, der für jeden Hyperlink im HyperLinkField Objekt angezeigt werden soll, oder legt diesen fest. |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement die Clienteingabe überprüft. (Geerbt von DataControlField) |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von DataControlField) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Datensteuerelementfeld gerendert wird. (Geerbt von DataControlField) |
Methoden
| Name | Beschreibung |
|---|---|
| CloneField() |
Erstellt eine duplizierte Kopie des aktuellen DataControlFieldabgeleiteten 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 dem aktuellen Objekt entspricht. (Geerbt von Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Extrahiert den Wert des Datensteuerelementfelds aus der aktuellen Tabellenzelle und fügt den Wert der angegebenen IDictionary Auflistung hinzu. (Geerbt von DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Formatiert die Navigations-URL mithilfe der von der DataNavigateUrlFormatString Eigenschaft angegebenen Formatzeichenfolge. |
| FormatDataTextValue(Object) |
Formatiert den Beschriftungstext mithilfe der von der DataTextFormatString Eigenschaft angegebenen Formatzeichenfolge. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die 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 zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnFieldChanged() |
Löst das |
| SaveViewState() |
Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet 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 am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField) |
| ValidateSupportsCallback() |
Gibt an, dass die im HyperLinkField Objekt enthaltenen Steuerelemente Rückrufe unterstützen. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Ruft das diesem DataControlField Objekt zugeordnete Schema ab oder legt es fest. (Geerbt von DataControlField) |
| IStateManager.IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField) |
| IStateManager.LoadViewState(Object) |
Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelementfelds wieder her. (Geerbt von DataControlField) |
| IStateManager.SaveViewState() |
Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet wurde. (Geerbt von DataControlField) |
| IStateManager.TrackViewState() |
Bewirkt, dass das DataControlField Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField) |
