Bagikan melalui

IWebPart.Subtitle Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls.WebParts
Rakitan:
System.Web.dll

Mendapatkan string yang digabungkan dengan Title nilai properti untuk membentuk judul lengkap untuk WebPart kontrol.

public:
 property System::String ^ Subtitle { System::String ^ get(); };
public string Subtitle { get; }
member this.Subtitle : string
Public ReadOnly Property Subtitle As String

Nilai Properti

String

String yang berfungsi sebagai subtitel untuk kontrol. Nilai default adalah string kosong ("").

Contoh

Contoh kode berikut menunjukkan penggunaan Subtitle properti yang deklaratif dan terprogram. Kode sumber lengkap untuk contoh ditemukan di bagian Contoh dari IWebPart gambaran umum kelas.

Bagian pertama dari contoh kode menunjukkan bagaimana kontrol pengguna mengimplementasikan Subtitle properti . Perhatikan bahwa properti bersifat baca-saja dan dimaksudkan untuk digunakan untuk memberikan subtitel default yang ditambahkan ke judul utama kontrol.

public string Subtitle
{
  get
  {
    object objSubTitle = ViewState["Subtitle"];
    if (objSubTitle == null)
      return "My Subtitle";

    return (string)objSubTitle;
  }

}

ReadOnly Property Subtitle() As String _
  Implements IWebPart.Subtitle
  Get
    Dim objSubTitle As Object = ViewState("Subtitle")
    If objSubTitle Is Nothing Then
      Return "My Subtitle"
    End If
    Return CStr(objSubTitle)
  End Get
End Property

Bagian kedua dari contoh kode menunjukkan bagaimana kontrol pengguna yang mengimplementasikan IWebPart antarmuka direferensikan dalam WebPartZone kontrol, dan bagaimana properti bisa-tulis diatur IWebPart secara deklaratif pada kontrol. Setelah Anda memuat halaman di browser, perhatikan bahwa nilai Subtitle default properti, yang diatur dalam kode implementasi kontrol pengguna, ditambahkan ke judul di bilah judul kontrol.

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

<%@ page language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="AccountUserControlVB" 
    src="AccountUserControlvb.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:AccountUserControlVB 
            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>

Keterangan

Properti Subtitle digunakan untuk mengembalikan string subtitel default untuk WebPart kontrol yang ditambahkan ke judul kontrol di bilah judul.

Jika Anda memberikan nilai default untuk Subtitle properti dalam kontrol yang mengimplementasikan IWebPart antarmuka, set kontrol Bagian Web secara otomatis menambahkannya ke nilai Title properti kontrol pada durasi.

Berlaku untuk

Lihat juga