HyperLinkField Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет поле, которое отображается как гиперссылка в элементе управления с привязкой к данным.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Наследование
Примеры
В следующем примере кода показано, как использовать HyperLinkField объект для отображения столбца статических гиперссылок в элементе GridView управления. Каждая гиперссылка в объекте HyperLinkField имеет одинаковые заголовки и URL-адрес навигации, заданные Text соответствующими свойствами и NavigateUrl свойствами.
<%@ 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>
В следующем примере кода показано, как привязать HyperLinkField объект к полям в источнике данных. DataNavigateUrlFields Свойства DataTextField используются для указания полей для привязки к заголовку и URL-адресу навигации соответственно каждой гиперссылки, отображаемой в объектеHyperLinkField.
<%@ 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>
Комментарии
Класс HyperLinkField используется элементами управления с привязкой к данным (например GridView , и DetailsView) для отображения гиперссылки для каждой отображаемой записи. Когда пользователь щелкает гиперссылку, он направляется на веб-страницу, связанную с гиперссылкой. Объект HyperLinkField отображается по-разному в зависимости от элемента управления с привязкой к данным, в котором он используется. Например, GridView элемент управления отображает HyperLinkField объект в виде столбца, а DetailsView элемент управления отображает его как строку.
Чтобы указать заголовок, отображаемый для гиперссылок, используйте Text свойство. NavigateUrl Используйте свойство, чтобы указать URL-адрес для перехода по щелчку гиперссылки. Если вы хотите отобразить связанное содержимое в определенном окне или фрейме, задайте Target свойство.
Примечание
Text Если заданы свойства, NavigateUrl все гиперссылки в HyperLinkField объекте имеют одинаковые заголовки и URL-адрес навигации. Аналогичным образом свойство Target также применяется ко всем гиперссылкам.
Кроме того, объект можно привязать HyperLinkField к полям в источнике данных. Это позволяет отображать разные заголовки для каждой гиперссылки в объекте и переходить по каждой гиперссылке HyperLinkField в другое расположение. Чтобы привязать поле к заголовку DataTextField , задайте свойство. Чтобы создать URL-адрес для навигации, задайте DataNavigateUrlFields для свойства разделенный запятыми список полей, которые будут использоваться для создания URL-адреса.
Вы можете указать пользовательский формат заголовков и URL-адресов навигации, задав DataTextFormatString параметры и DataNavigateUrlFormatString свойства соответственно.
Объект можно скрыть HyperLinkField в элементе управления, привязанном к falseданным, задав Visible для свойства значение .
Вы можете настроить разделы верхнего и нижнего HyperLinkField колонтитулов объекта. Чтобы отобразить заголовок в разделах верхнего или нижнего колонтитулов, задайте HeaderText значения или FooterText свойства соответственно. Чтобы отобразить изображение в разделе заголовка вместо текста, задайте HeaderImageUrl свойство. Раздел заголовка можно скрыть в объекте HyperLinkField , задав ShowHeader для свойства значение false.
Примечание
Некоторые элементы управления с привязкой к данным (например, GridView элемент управления) могут отображать или скрывать только весь раздел заголовка элемента управления. Эти элементы управления с привязкой ShowHeader к данным не поддерживают свойство для отдельного привязанного поля. Чтобы отобразить или скрыть весь раздел заголовка элемента управления с привязкой к данным, используйте свойство элемента управления ShowHeader (если доступно).
Вы также можете настроить внешний вид объекта (цвет шрифта HyperLinkField , цвет фона и т. д.), задав свойства стиля для различных частей поля. В следующей таблице перечислены различные свойства стиля.
| Свойство Style | Описание |
|---|---|
| ControlStyle | Параметры стиля для дочерних элементов управления HyperLinkField веб-сервера объекта. |
| FooterStyle | Параметры стиля для раздела нижнего HyperLinkField колонтитула объекта. |
| HeaderStyle | Параметры стиля для раздела заголовка HyperLinkField объекта. |
| ItemStyle | Параметры стиля для элементов данных в объекте HyperLinkField . |
Конструкторы
| HyperLinkField() |
Инициализирует новый экземпляр класса HyperLinkField. |
Свойства
| AccessibleHeaderText |
Возвращает или задает текст, отображающийся как значение свойство |
| Control |
Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField. (Унаследовано от DataControlField) |
| ControlStyle |
Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField. (Унаследовано от DataControlField) |
| DataNavigateUrlFields |
Возвращает или задает имена полей из источника данных, используемых для формирования URL-адресов для гиперссылок в объекте HyperLinkField. |
| DataNavigateUrlFormatString |
Возвращает или задает строку, определяющую формат, по которому генерируются URL-адреса гиперссылок в объекте HyperLinkField. |
| DataTextField |
Возвращает или задает имя поля из источника данных, содержащего текст, который отображается в виде сигнатур к гиперссылкам в объекте HyperLinkField. |
| DataTextFormatString |
Возвращает или задает строку, указывающую формат, в котором отображаются подписи гиперссылок в объекте HyperLinkField. |
| DesignMode |
Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки. (Унаследовано от DataControlField) |
| FooterStyle |
Возвращает или задает стиль нижнего колонтитула поля элемента управления данными. (Унаследовано от DataControlField) |
| FooterText |
Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField) |
| HeaderImageUrl |
Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField) |
| HeaderStyle |
Возвращает или задает стиль верхнего колонтитула поля элемента управления данными. (Унаследовано от DataControlField) |
| HeaderText |
Возвращает или задает текст для отображения в верхнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField) |
| InsertVisible |
Возвращает значение, указывающее состояние отображения объекта DataControlField во время пребывания его родительского элемента управления, привязанного к данным, в режиме вставки. (Унаследовано от DataControlField) |
| IsTrackingViewState |
Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления. (Унаследовано от DataControlField) |
| ItemStyle |
Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием. (Унаследовано от DataControlField) |
| NavigateUrl |
Возвращает или задает URL-адрес для перехода при щелчке по гиперссылке в объекте HyperLinkField. |
| ShowHeader |
Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными. (Унаследовано от DataControlField) |
| SortExpression |
Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных. (Унаследовано от DataControlField) |
| Target |
Возвращает или задает целевое окно или фрейм, в котором отображается содержимое веб-страницы при переходе по гиперссылке в объекте HyperLinkField. |
| Text |
Возвращает или задает текст, отображаемый для всех гиперссылок в объекте HyperLinkField. |
| ValidateRequestMode |
Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод. (Унаследовано от DataControlField) |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы. (Унаследовано от DataControlField) |
| Visible |
Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными. (Унаследовано от DataControlField) |
Методы
| CloneField() |
Создает точную копию текущего объекта, производного от DataControlField. (Унаследовано от DataControlField) |
| CopyProperties(DataControlField) |
Копирует свойства текущего объекта HyperLinkField в указанный объект. |
| CreateField() |
Возвращает новый экземпляр класса HyperLinkField. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Добывает значение поля элемента управления данными из текущей ячейки таблицы и добавляет значение в указанную коллекцию IDictionary. (Унаследовано от DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Форматирует URL-адрес, используя строку формата, заданную в свойстве DataNavigateUrlFormatString. |
| FormatDataTextValue(Object) |
Форматирует строку подписи с использованием строки формата, заданной свойством DataTextFormatString. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| Initialize(Boolean, Control) |
Выполняет инициализацию объекта HyperLinkField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Инициализирует ячейку в объекте HyperLinkField. |
| LoadViewState(Object) |
Восстанавливает сохраненное раннее состояние представления источника данных. (Унаследовано от DataControlField) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| OnFieldChanged() |
Вызывает событие |
| SaveViewState() |
Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер. (Унаследовано от DataControlField) |
| ToString() |
Возврат строки, представляющей объект DataControlField. (Унаследовано от DataControlField) |
| TrackViewState() |
Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от DataControlField) |
| ValidateSupportsCallback() |
Указывает, что элементы управления, содержащиеся в HyperLinkField, поддерживают обратные вызовы. |
Явные реализации интерфейса
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Возвращает или задает схему, связанную с этим объектом DataControlField. (Унаследовано от DataControlField) |
| IStateManager.IsTrackingViewState |
Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления. (Унаследовано от DataControlField) |
| IStateManager.LoadViewState(Object) |
Восстанавливает сохраненное раннее состояние представления поля источника данных. (Унаследовано от DataControlField) |
| IStateManager.SaveViewState() |
Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер. (Унаследовано от DataControlField) |
| IStateManager.TrackViewState() |
Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от DataControlField) |