HyperLinkField Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar ett fält som visas som en hyperlänk i en databunden kontroll.

public ref class HyperLinkField : System::Web::UI::WebControls::DataControlField

public class HyperLinkField : System.Web.UI.WebControls.DataControlField

type HyperLinkField = class
    inherit DataControlField

Public Class HyperLinkField
Inherits DataControlField

Arv: Object

DataControlField
HyperLinkField

Exempel

I följande kodexempel visas hur du använder ett HyperLinkField objekt för att visa en kolumn med statiska hyperlänkar i en GridView kontroll. Varje hyperlänk i HyperLinkField objektet delar samma bildtext och navigerings-URL som anges av Text egenskaperna och 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>

I följande kodexempel visas hur du binder ett HyperLinkField objekt till fält i en datakälla. Egenskaperna DataTextField och DataNavigateUrlFields används för att ange fälten som ska bindas till bildtexten respektive navigerings-URL:en för varje hyperlänk som visas i HyperLinkField objektet.


<%@ 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>

Kommentarer

Klassen HyperLinkField används av databundna kontroller (till exempel och GridView) för att visa en hyperlänk för varje post som DetailsView visas. När användaren klickar på en hyperlänk dirigeras de till den webbsida som är associerad med hyperlänken. Objektet HyperLinkField visas på olika sätt beroende på den databundna kontroll som det används i. Kontrollen visar till exempel GridView ett HyperLinkField objekt som en kolumn, medan DetailsView kontrollen visar det som en rad.

Om du vill ange vilken undertext som ska visas för hyperlänkarna använder du Text egenskapen . Använd egenskapen NavigateUrl för att ange url:en som ska navigeras till när en hyperlänk klickas. Om du vill visa det länkade innehållet i ett visst fönster eller en viss ram anger du egenskapen Target .

Note

Text När egenskaperna och NavigateUrl anges delar alla hyperlänkar i HyperLinkField objektet samma bildtext och navigerings-URL. På samma sätt gäller egenskapen Target även för alla hyperlänkar.

Du kan också binda HyperLinkField objektet till fält i en datakälla. På så sätt kan du visa en annan undertext för varje hyperlänk i HyperLinkField objektet och låta varje hyperlänk navigera till en annan plats. Om du vill binda ett fält till en bildtext anger du egenskapen DataTextField . Om du vill skapa en URL för navigering anger du DataNavigateUrlFields egenskapen till en kommaavgränsad lista med fält som ska användas för att skapa URL:en.

Du kan ange ett anpassat format för bildtexter och navigerings-URL:er genom att ange DataTextFormatString egenskaperna och DataNavigateUrlFormatString .

Du kan dölja ett HyperLinkField objekt i en databunden kontroll genom att ange Visible egenskapen till false.

Du kan anpassa sidhuvud- och sidfotsavsnitten i ett HyperLinkField objekt. Om du vill visa en bildtext i sidhuvud- eller sidfotsavsnitten HeaderText FooterText anger du respektive egenskaper. Om du vill visa en bild i rubrikavsnittet i stället för text anger du egenskapen HeaderImageUrl . Rubrikavsnittet kan döljas i HyperLinkField objektet genom att ställa in egenskapen på ShowHeaderfalse .

Note

Vissa databundna kontroller (till exempel GridView kontrollen) kan bara visa eller dölja hela rubrikavsnittet i kontrollen. Dessa databundna kontroller stöder inte egenskapen ShowHeader för ett enskilt bundet fält. Om du vill visa eller dölja hela rubrikavsnittet i en databunden kontroll använder du kontrollens egenskap (om den är ShowHeader tillgänglig).

Du kan också anpassa objektets HyperLinkField utseende (teckenfärg, bakgrundsfärg och så vidare) genom att ange formategenskaperna för de olika delarna av fältet. I följande tabell visas de olika stilegenskaperna.

Formategenskap	Description
ControlStyle	Formatinställningarna för de underordnade webbserverkontrollerna för HyperLinkField objektet.
FooterStyle	Formatinställningarna för sidfotsavsnittet i HyperLinkField objektet.
HeaderStyle	Formatinställningarna för rubrikavsnittet i HyperLinkField objektet.
ItemStyle	Formatinställningarna för dataobjekten HyperLinkField i objektet.

Konstruktorer

Name	Description
HyperLinkField()	Initierar en ny instans av HyperLinkField klassen.

Egenskaper

Name	Description
AccessibleHeaderText	Hämtar eller anger text som återges som egenskapsvärdet `AbbreviatedText` i vissa kontroller. (Ärvd från DataControlField)
Control	Hämtar en referens till den datakontroll som DataControlField objektet är associerat med. (Ärvd från DataControlField)
ControlStyle	Hämtar formatet för alla webbserverkontroller som ingår i DataControlField objektet. (Ärvd från DataControlField)
DataNavigateUrlFields	Hämtar eller anger namnen på fälten från datakällan som används för att konstruera URL:er för hyperlänkarna i HyperLinkField objektet.
DataNavigateUrlFormatString	Hämtar eller anger strängen som anger i vilket format URL:erna för hyperlänkarna i ett HyperLinkField objekt återges.
DataTextField	Hämtar eller anger namnet på fältet från datakällan som innehåller texten som ska visas för hyperlänktexterna i HyperLinkField objektet.
DataTextFormatString	Hämta eller anger strängen som anger i vilket format hyperlänktexterna i ett HyperLinkField objekt ska visas.
DesignMode	Hämtar ett värde som anger om ett datakontrollfält för närvarande visas i en designtidsmiljö. (Ärvd från DataControlField)
FooterStyle	Hämtar eller anger formatet för sidfoten för datakontrollfältet. (Ärvd från DataControlField)
FooterText	Hämtar eller anger texten som visas i sidfotsobjektet i ett datakontrollfält. (Ärvd från DataControlField)
HeaderImageUrl	Hämtar eller anger URL:en för en bild som visas i rubrikobjektet i ett datakontrollfält. (Ärvd från DataControlField)
HeaderStyle	Hämtar eller anger formatet för huvudet i datakontrollfältet. (Ärvd från DataControlField)
HeaderText	Hämtar eller anger den text som visas i rubrikobjektet i ett datakontrollfält. (Ärvd från DataControlField)
InsertVisible	Hämtar ett värde som anger om DataControlField objektet är synligt när dess överordnade databundna kontroll är i infogningsläge. (Ärvd från DataControlField)
IsTrackingViewState	Hämtar ett värde som anger om DataControlField objektet sparar ändringar i visningstillståndet. (Ärvd från DataControlField)
ItemStyle	Hämtar formatmallen för textbaserat innehåll som visas av ett datakontrollfält. (Ärvd från DataControlField)
NavigateUrl	Hämtar eller anger url:en som ska navigeras till när en hyperlänk i ett HyperLinkField objekt klickas.
ShowHeader	Hämtar eller anger ett värde som anger om rubrikobjektet i ett datakontrollfält återges. (Ärvd från DataControlField)
SortExpression	Hämtar eller anger ett sorteringsuttryck som används av en datakällakontroll för att sortera data. (Ärvd från DataControlField)
Target	Hämtar eller anger målfönstret eller ramen där webbsidan som är länkad till visas när en hyperlänk i ett HyperLinkField objekt klickas.
Text	Hämtar eller ställer in texten som ska visas för varje hyperlänk i HyperLinkField objektet.
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen validerar klientindata. (Ärvd från DataControlField)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett DataControlField objekt över flera begäranden för samma sida. (Ärvd från DataControlField)
Visible	Hämtar eller anger ett värde som anger om ett datakontrollfält återges. (Ärvd från DataControlField)

Metoder

Name	Description
CloneField()	Skapar en duplicerad kopia av det aktuella DataControlField-härledda objektet. (Ärvd från DataControlField)
CopyProperties(DataControlField)	Kopierar egenskaperna för det aktuella HyperLinkField objektet till det angivna objektet.
CreateField()	Returnerar en ny instans av HyperLinkField klassen.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extraherar värdet för datakontrollfältet från den aktuella tabellcellen och lägger till värdet i den angivna IDictionary samlingen. (Ärvd från DataControlField)
FormatDataNavigateUrlValue(Object[])	Formaterar navigerings-URL:en med den formatsträng som anges av egenskapen DataNavigateUrlFormatString .
FormatDataTextValue(Object)	Formaterar textrubriken med den formatsträng som anges av egenskapen DataTextFormatString .
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
Initialize(Boolean, Control)	Initierar HyperLinkField-objektet.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initierar en cell i ett HyperLinkField objekt.
LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från DataControlField)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnFieldChanged()	Genererar händelsen `FieldChanged` . (Ärvd från DataControlField)
SaveViewState()	Sparar de ändringar som gjorts i visningstillståndet DataControlField sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från DataControlField)
ToString()	Returnerar en sträng som representerar det här DataControlField objektet. (Ärvd från DataControlField)
TrackViewState()	DataControlField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida. (Ärvd från DataControlField)
ValidateSupportsCallback()	Anger att kontrollerna som ingår i HyperLinkField objektet stöder återanrop.

Explicita gränssnittsimplementeringar

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Hämtar eller anger schemat som är associerat med det här DataControlField objektet. (Ärvd från DataControlField)
IStateManager.IsTrackingViewState	Hämtar ett värde som anger om DataControlField objektet sparar ändringar i visningstillståndet. (Ärvd från DataControlField)
IStateManager.LoadViewState(Object)	Återställer datakontrollfältets tidigare sparade visningstillstånd. (Ärvd från DataControlField)
IStateManager.SaveViewState()	Sparar de ändringar som gjorts i visningstillståndet DataControlField sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från DataControlField)
IStateManager.TrackViewState()	DataControlField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida. (Ärvd från DataControlField)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?