Part Sınıf

Tanım

public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessor

public abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor

type Part = class
    inherit Panel
    interface INamingContainer
    interface ICompositeControlDesignerAccessor

Public MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer

Devralma

Object

Control

WebControl

Panel

Part

Türetilmiş

System.Web.UI.WebControls.WebParts.CatalogPart

System.Web.UI.WebControls.WebParts.EditorPart

System.Web.UI.WebControls.WebParts.WebPart

Uygulamalar

INamingContainer ICompositeControlDesignerAccessor

Örnekler

Aşağıdaki kod örnekleri, ASP.NET Web sayfasında başvuruda bulunan bir özel WebPart denetimin Part iki örneğini kullanarak sınıfın çeşitli özelliklerinin bildirim temelli kullanımını gösterir. Kod örneğinin çalışması için bu kaynak kodunu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin App_Code klasörüne koyabilirsiniz; burada çalışma zamanında dinamik olarak derlenir. Her iki derleme yöntemini de gösteren bir izlenecek yol için bkz. İzlenecek Yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

Örneğin ilk bölümü, adlı TextDisplayWebPartözel denetimin kodunu içerir. Denetim öğesinden WebParttüretildiği için, sınıfın sağladığı ortak özellikleri Part de devralır ve bu kod örneğinde bu özelliklerin kullanımını gösterir.

using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    const string _subTitle = "Contoso, Ltd";

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

    [
      Personalizable(PersonalizationScope.User, true),
      WebBrowsable()
    ]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
      ChildControlsCreated = true;
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
        // Clear the input textbox.
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    
    
    Public Sub New() 
      Me.AllowClose = False
    End Sub
    
    <Personalizable(), WebBrowsable()>  _
    Public Property ContentText() As String 
        Get
            Return _contentText
        End Get
        Set
            _contentText = value
        End Set
    End Property
     
    Protected Overrides Sub CreateChildControls() 
        Controls.Clear()
        DisplayContent = New Label()
        DisplayContent.Text = Me.ContentText
        DisplayContent.BackColor = _
          System.Drawing.Color.LightBlue
        Me.Controls.Add(DisplayContent)
        input = New TextBox()
        Me.Controls.Add(input)
        Dim update As New Button()
        update.Text = "Set Label Content"
        AddHandler update.Click, AddressOf Me.submit_Click
        Me.Controls.Add(update)
        ChildControlsCreated = True
    
    End Sub
    
    
    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs) 
        ' Update the label string.
        If input.Text <> String.Empty Then
            Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
            ' Clear the input textbox.
            input.Text = String.Empty
            DisplayContent.Text = Me.ContentText
        End If
    
    End Sub
    
End Class

End Namespace

Örneğin ikinci bölümünde, ASP.NET Web sayfasındaki özel bölüm denetimlerine nasıl başvuracakları gösterilmektedir. Çeşitli Part özelliklerin özel denetim örneklerine bildirimli olarak atandığını görebilirsiniz. Sayfadaki iki örneğe başvuran bildirim temelli kodu karşılaştırın ve ardından sayfayı bir tarayıcıda yükleyin. Çeşitli özelliklerin denetimlerin görünümünü nasıl etkilediğine dikkat edin. Örneğin, sayfayı bir tarayıcıda yükledikten sonra, özellik değeri olarak ayarlandığından Minimizeddenetimin TextDisplayWebPartChromeState ikinci örneği simge durumuna küçültülmüş olarak görünür.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS" %>

<!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 id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB" %>

<!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 id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Açıklamalar

Part sınıfı, tüm bölüm denetimleri için ortak olan özellikleri tanımlar ve bir Web sayfasında modüler ve tutarlı bir görünüme sahip olmalarını sağlar. Bu yaygın özellikler bir başlık, açıklama ve parça denetimini çevreleyen krom veya çerçevenin özelliklerini içerir.

Title özelliği, parça denetimi için bir başlık belirtir. Description özelliği, parça denetiminin amacını özetlemek için kullanılır ve denetimin başlık çubuğunda Araç İpucu olarak görünür. ChromeType özelliği, bir parça denetimi çevresinde ne tür bir kenarlık işlendiğini belirlerken, özelliği bir parça denetiminin ChromeState normal olarak mı yoksa simge durumuna küçültülmüş olarak mı işlendiğini gösterir. Bir parça denetiminin kenarlıkları, denetimi içeren bölgenin özelliklerinden etkilenir; örneğin, PartChromeType özelliği bir bölgede bulunan tüm parça denetimlerinin çerçevelerini etkiler.

Parça denetimi türlerinden biri, içeriği ilgili bölgenin içinde işleyen denetimdir WebPart . Başka bir tür, EditorPart tek tek WebPart denetimleri değiştirmek (kişiselleştirmek) için kullanılan kullanıcı arabirimi (UI) denetimleri sağlayan denetimdir. Üçüncü bir parça denetimi türü, kullanıcıların Web sayfasına ekleyebilecekleri veya web sayfasından kaldırabilecekleri denetimlerin WebPart listesini sağlayan denetimdirCatalogPart.

Bölüm denetimleri, tümü soyut WebZone sınıftan türetilen bölgelerde bulunur. Bölge, içerdiği parça denetimlerini düzenlemekle sorumludur. Her bölge ayrıca üst bilgi, alt bilgi, başlık çubuğu ve kenarlıklar gibi her bir parça denetiminin etrafındaki kullanıcı arabirimi öğeleri de dahil olmak üzere ui öğelerini kendisi için işler.

Temel parça türlerine ve bunlara karşılık gelen bölge türlerine ilişkin bazı örnekler aşağıdaki tabloda gösterilmiştir.

sınıfından türetilen Part çeşitli parça denetimleri devralınan, UI odaklı özellikleri farklı işler. WebPart denetimler devralınan ui özelliklerinin birkaçını geçersiz kılar ve bunları özniteliğiyle Personalizable (ayrıntılar için sınıf belgelerine bakın PersonalizableAttribute ) işaretleyerek bu özelliklerin değerlerinin kişiselleştirme olarak bilinen gelecek tarayıcı oturumları için kaydedilmesini sağlar. Örneğin, bir kullanıcının çalışma zamanında denetimin Title özelliğinin WebPart değerini güncelleştirmesini program aracılığıyla etkinleştirirseniz, bu değer kişiselleştirilmiş olur (varsayılan olan kişiselleştirmenin etkinleştirildiği varsayılır). Denetimin sınıfından WebPart ve WebControl sınıfından Part devraldığı çeşitli ui özellikleri aynı şekilde işlenir.

Buna karşılık, ve CatalogPartgibi EditorPart diğer bölüm denetimleri devralınan kullanıcı arabirimi özelliklerinin kişiselleştirilebilmesini sağlamaz. Bu nedenle, program aracılığıyla atanan özellik değerleri gelecekteki tarayıcı oturumları için kaydedilmez. Örneğin, kullanıcının çalışma zamanında denetimin özelliğini güncelleştirmesini PropertyGridEditorPart program aracılığıyla etkinleştirirseniz, denetim Title kapatıldıktan veya tarayıcı oturumu sona erdikten sonra güncelleştirilmiş değer kaybolur.

Gelecekteki tarayıcı oturumları için ve CatalogPart denetimleri için EditorPart bu tür devralınan UI özelliklerindeki değerleri kaydetmenin kolay bir yolu, özellik değerlerini sayfa kalıcılığı biçiminde bildirmektir. Ancak, bu statik bir yaklaşımdır ve yine de kullanıcıların özellik değerlerini kişiselleştirmesine izin vermez. Alternatif olarak, kullanıcıların çalışma zamanında bunları kişiselleştirebilmesi için devralınan ui özelliklerinde programlı güncelleştirmeleri etkinleştirmek istiyorsanız, özellik değerlerini kaydetmek için özel, statik değişkenler kullanabilirsiniz. Bir veya CatalogPart denetiminin EditorPart yeni bir örneği her oluşturulduğunda (örneğin, denetimin Init olayını işleyen yöntemde), statik değişkenin değerini ilgili özelliğe yeniden atayabilirsiniz. Böyle bir yaklaşım, kullanıcılara Web Bölümleri uygulamasının düzenleme kullanıcı arabirimini ve katalog kullanıcı arabirimini kişiselleştirme olanağı sağlar.

Uygulayanlara Notlar

Normalde, özel Web Bölümleri denetimleri geliştirmek için doğrudan sınıfından Part devralmamalısınız. Tam Web Bölümleri işlevselliği sağlamak için, Web Bölümleri denetim kümesi , ve CatalogPartsınıfından EditorPartPartWebParttüretilmiş sınıfları gerektirir, bu nedenle özel denetimler geliştirmek için bunlardan türetmelisiniz. Ancak, diğer tüm bölüm sınıfları tarafından kullanılan ortak bir özellik kümesi sağladığından, temel Part sınıfın davranışını anlamak hala önemlidir.

Özellikler

Yöntemler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• ASP.NET Web Bölümlerine Genel Bakış
• Web Bölümleri Denetim Kümesine Genel Bakış
• Web Bölümleri Denetimlerini ASP.NET