HyperLinkField Konstruktor
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci HyperLinkField třídy.
public:
HyperLinkField();public HyperLinkField();Public Sub New ()Příklady
Následující příklad kódu ukazuje, jak pomocí konstruktoru dynamicky přidat HyperLinkField objekt do GridView ovládacího prvku.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
// Dynamically create field columns to display the desired
// fields from the data source. This only needs to be done
// the first time the page is loaded because the GridView
// control persists its column fields.
if (!IsPostBack)
{
// Create a HyperLinkField object to display the company's
// name. Bind the CompanyName and HomePage fields from the
// Northwind database to the caption and URL of the hyperlinks
// in the HyperLinkField field column. Note that the URLs
// specified in the Northwind database might not be valid URLs.
HyperLinkField companyNameBoundField = new HyperLinkField ();
string[] dataNavigateUrlFields = { "HomePage" };
companyNameBoundField.DataTextField = "CompanyName";
companyNameBoundField.DataNavigateUrlFields = dataNavigateUrlFields;
companyNameBoundField.HeaderText = "Company Name";
companyNameBoundField.Target = "_blank";
// Create a BoundField object to display the company's city.
BoundField cityBoundField = new BoundField ();
cityBoundField.DataField = "city";
cityBoundField.HeaderText = "City";
// Add the field columns to the Columns collection of the
// GridView control.
SuppliersGridView.Columns.Add (companyNameBoundField);
SuppliersGridView.Columns.Add (cityBoundField);
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HyperLinkField Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Constructor Example</h3>
<asp:gridview id="SuppliersGridView"
datasourceid="SuppliersSqlDataSource"
autogeneratecolumns="False"
runat="server">
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="SuppliersSqlDataSource"
selectcommand="SELECT [SupplierID], [CompanyName], [City], [HomePage] FROM [Suppliers]"
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">
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Dynamically create field columns to display the desired
' fields from the data source. This only needs to be done
' the first time the page is loaded because the GridView
' control persists its column fields.
If Not IsPostBack Then
' Create a HyperLinkField object to display the company's
' name. Bind the CompanyName and HomePage fields from the
' Northwind database to the caption and URL of the hyperlinks
' in the HyperLinkField field column. Note that the URLs
' specified in the Northwind database might not be valid URLs.
Dim companyNameBoundField As New HyperLinkField
Dim dataNavigateUrlFields() As String = {"HomePage"}
companyNameBoundField.DataTextField = "CompanyName"
companyNameBoundField.DataNavigateUrlFields = dataNavigateUrlFields
companyNameBoundField.HeaderText = "Company Name"
companyNameBoundField.Target = "_blank"
' Create a BoundField object to display the company's city.
Dim cityBoundField As New BoundField
cityBoundField.DataField = "city"
cityBoundField.HeaderText = "City"
' Add the field columns to the Columns collection of the
' GridView control.
SuppliersGridView.Columns.Add(companyNameBoundField)
SuppliersGridView.Columns.Add(cityBoundField)
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HyperLinkField Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Constructor Example</h3>
<asp:gridview id="SuppliersGridView"
datasourceid="SuppliersSqlDataSource"
autogeneratecolumns="False"
runat="server">
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="SuppliersSqlDataSource"
selectcommand="SELECT [SupplierID], [CompanyName], [City], [HomePage] FROM [Suppliers]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Poznámky
Tento konstruktor použijte k inicializaci nové instance HyperLinkField třídy. Tento konstruktor se běžně používá při přidávání polí do dynamicky vytvořeného ovládacího prvku vázaného na data.
Pokud chcete dynamicky přidat HyperLinkField objekt do ovládacího prvku vázaného na data, vytvořte nový HyperLinkField objekt, nastavte jeho vlastnosti a pak ho přidejte do kolekce polí ovládacího prvku vázaného na data. Pokud například používáte GridView ovládací prvek, přidejte HyperLinkField objekt do Columns kolekce.
Note
I když můžete dynamicky přidávat pole do ovládacího prvku vázaného na data, důrazně doporučujeme, aby byla pole staticky deklarována a poté zobrazena nebo skryta podle potřeby. Staticky deklarování všech polí zmenšuje velikost stavu zobrazení pro nadřazený ovládací prvek svázaný s daty.
