This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

HyperLinkField.DataTextField الخاصية

Visual Studio 2010

وهذا يسمح لك بعرض تسمية توضيحية مختلفة لكل ارتباط تشعبي في HyperLinkFieldكائن ولكي يقوم كل ارتباط تشعبي التنقل إلى الموقع مختلف.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

[TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string DataTextField { get; set; }

قيمة الخاصية

النوع: System.String
إلى يربط حقل إلى تعيين تسمية توضيحية، HyperLinkFieldخاصية. الافتراضي هو سلسلة فارغ ("")، التي تشير إلى تلك th هو خاصية هو لم يتم تعيينها.

لإنشاء محدد موقع معلومات ل التنقل، قم بتعيين DataTextFieldخاصية إلى قائمة مفصولة بفواصل حقول التي سيتم استخدامها لإنشاء محدد موقع المعلومات.HyperLinkField

يمكنك تحديد تنسيق مخصص للتسميات التوضيحية ومحددات مواقع المعلومات URL التنقل بتعيين Textو الخصائص، على التوالي. يوضح المثال تعليمات برمجية التالي كيفية استخدام الكائن لعرض عمود ثابت الارتباطات التشعبية الموجودة في عنصر تحكم.

ملاحظةملاحظة

إذا تعارض DataTextFieldيتم تعريف الكائنات، Textعنصر تحكم تطبيق عمليات الربط لعنصر قائمة في ترتيب الأسبقية التالي:DataTextField

كل ارتباط تشعبي في 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 DataBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>HyperLinkField DataBinding Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- 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.                            -->
      <asp:gridview id="SuppliersGridView" 
        datasourceid="SuppliersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">

        <columns>

          <asp:hyperlinkfield datatextfield="CompanyName"
            datanavigateurlfields="HomePage"          
            headertext="Company Name"
            target="_blank" />
          <asp:boundfield datafield="City" 
            headertext="City"/>

        </columns>

      </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>



يوضح المثال تعليمات برمجية التالي كيفية يربط DataTextFormatStringالكائن إلى الحقول في بيانات المصدر.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>



نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: