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.Title الخاصية

Visual Studio 2010

Gets أو sets the عنوان of a WebPart عنصر تحكم.

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

string Title { get; set; }

قيمة الخاصية

النوع: System.String
A سلسلة that يحتوي على the عنوان of the عنصر تحكم. القيمة افتراضية سلسلة فارغ ("").

نص العنوان vهوible في شريط العنوان لعنصر تحكم هو تعيين بواسطة Titleالخاصية.

إذا كنت لا تقم بإدخال عنوان عنصر تحكم، "أجزاء ويب" عنصر تحكم مجموعة تلقائياً بحساب سلسلة افتراضي المراد استخدامه كعنوان. لمزيد من المعلومات، راجع DisplayTitle. أيضا، فإنه هو ممكن لتوفير افتراضي عنوان الفرعي الذي هو إلحاقها بسلسلة عنوان. للمزيد من التفاصيل ، راجع Subtitle.

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

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


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

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


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

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

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب 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عنصر التحكم، وكيف Titleالخاصية هو تعيينها بشكل إلزامي على عنصر التحكم.


<%@ 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
إظهار: