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.

IWebPart.TitleUrl الخاصية

Visual Studio 2010

الحصول على أو قم بتعيين محدد موقع معلومات إضافية حول WebPartعنصر تحكم.

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

string TitleUrl { get; set; }

قيمة الخاصية

النوع: System.String
سلسلة تمثل محدد موقع معلومات للحصول على مزيد من المعلومات حول WebPartعنصر تحكم. القيمة افتراضية سلسلة فارغ ("").

عندما تقوم بتعيين محدد موقع معلومات ل TitleUrlالخاصية، تظهر عنصر تحكم يصبح الارتباط. الغرض من هذه الخاصية توفير طريقة ملائمة للمستخدمين النهائيين الوصول إلى معلومات إضافية حول عنصر تحكم. The إضافى معلومات could provide حقوق النشر بيانات, جهة اتصال بيانات, تفاصيل حول the creator of the عنصر تحكم, أو a خلاصة of the عنصر تحكم's purpose.

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

Normally, you would not استخدم the TitleUrl خاصية إلى ارتباط إلى تعليمات محتوى. The best way إلى provide a ارتباط إلى تعليمات for a عنصر تحكم هو إلى استخدم the HelpUrl خاصية.

يوضح المثال تعليمات برمجية التالي مصرحة و الاستخدام البرمجي TitleUrlخاصية. The إكمال المصدر تعليمات برمجية for the مثال هو found في the مثال مقطع of the IWebPart فئة overview.

The أول part of the تعليمات برمجية مثال shows how the مستخدم عنصر تحكم implements the TitleUrl خاصية.


public string TitleUrl
{
  get
  {
    object objTitle = ViewState["TitleUrl"];
    if (objTitle == null)
      return String.Empty;

    return (string)objTitle;
  }
  set
  {
    ViewState["TitleUrl"] = value;
  }
}


الجزء الثاني من تعليمات برمجية يوضح المثال الأسلوب في عنصر تحكم المستخدم برمجياً بتعيين القيمة TitleUrlخاصية عندما يقوم مستخدم بتحديد اسم خاصية المناسبة من الأزرار الخيارات في الصفحة، قم بتعيين قيمة جديدة في صندوق النص، وثم النقر فوق الزر تحديث .

ملاحظة الأمانملاحظة الأمان

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب ASP.NET من أن مُدخلات المستخدم لا تتضمن برنامج نصي أو عناصر HTML. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.


// Update the selected IWebPart property value.
void Button1_Click(object sender, EventArgs e)
{
  String propertyValue = Server.HtmlEncode(TextBox3.Text);
  TextBox3.Text = String.Empty;

  switch (RadioButtonList1.SelectedValue)
  {
    case "title":
      this.Title = propertyValue;
      break;
    case "description":
      this.Description = propertyValue;
      break;
    case "catalogiconimageurl":
      this.CatalogIconImageUrl = propertyValue;
      break;
    case "titleiconimageurl":
      this.TitleIconImageUrl = propertyValue;
      break;
    case "titleurl":
      this.TitleUrl = propertyValue;
      break;
    default:
      break;
  }
}


الجزء الثالث من مثال التعليمة البرمجية يوضح كيفية التحكم المستخدم الذي يطبق IWebPartواجهة هو المشار إليه في WebPartZoneعنصر التحكم، وكيف TitleUrlالخاصية هو تعيينها بشكل إلزامي على عنصر التحكم. ملاحظة that if you do not provide a URL إلى a real الصفحة, و then a مستخدم clicks the ارتباط في the عنوان bar, an خطأ رسالة appears.


<%@ page language="c#" %>
<%@ register tagprefix="uc1" 
    tagname="AccountUserControlCS" 
    src="AccountUserControlcs.ascx"%>
<!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>
      Personalizable User Control with IWebPart Properties
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
      <asp:webpartzone 
        id="zone1" 
        runat="server" 
        headertext="Main" 
        CloseVerb-Enabled="false">
        <zonetemplate>
          <uc1:AccountUserControlCS 
            runat="server" 
            id="accountwebpart" 
            title="Account Form"
            Description="Account Form with default values."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconImageUrl="MyTitleIcon.gif"
            TitleUrl="MyUrl.html"/>
        </zonetemplate>
      </asp:webpartzone>    
    </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
إظهار: