CatalogZoneBase Klasa

Definicja

Służy jako klasa bazowa dla wszystkich kontrolek strefy, które działają jako wykazy.Serves as the base class for all zone controls that act as catalogs. Wykazy zawierają listy WebPart formantów, które użytkownicy mogą dodawać do strony sieci Web.Catalogs contain lists of WebPart controls that users can add to a Web page.

public ref class CatalogZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone, System::Web::UI::IPostBackDataHandler
public abstract class CatalogZoneBase : System.Web.UI.WebControls.WebParts.ToolZone, System.Web.UI.IPostBackDataHandler
type CatalogZoneBase = class
    inherit ToolZone
    interface IPostBackDataHandler
Public MustInherit Class CatalogZoneBase
Inherits ToolZone
Implements IPostBackDataHandler
Dziedziczenie
Pochodne
Implementuje

Przykłady

Poniższy przykład kodu ilustruje kilka deklaratywnych i programistycznych zastosowania CatalogZoneBase klasy.The following code example demonstrates several declarative and programmatic uses of the CatalogZoneBase class. Ponieważ Klasa jest abstrakcyjna, przykłady kodu używają klasy pochodnej, CatalogZone która jest dostarczana z zestawem kontrolnym składniki Web Part, wykazując właściwości i metody, które dziedziczy z CatalogZoneBase klasy.Because the class is abstract, the code examples use the derived CatalogZone class that ships with the Web Parts control set, demonstrating the properties and methods that it inherits from the CatalogZoneBase class.

Przykład kodu ma cztery części:The code example has four parts:

  • Kontrolka użytkownika, która umożliwia zmianę trybów wyświetlania na stronie sieci Web.A user control that enables you to change display modes on the Web page.

  • Strona sieci Web, która zawiera odwołanie do CatalogZone kontrolki i kod, który demonstruje użycie niektórych kluczowych CatalogZoneBase elementów członkowskich klasy.A Web page that contains a reference to a CatalogZone control, and some code that demonstrates usage of some key CatalogZoneBase class members.

  • Kontrolka niestandardowa WebPart , która jest dodawana do CatalogZone kontrolki niestandardowej.A custom WebPart control that is added to the custom CatalogZone control.

  • Opis sposobu działania przykładu w przeglądarce.A description of how the example works in a browser.

Pierwszym elementem tego przykładu kodu jest kontrolka użytkownika, która umożliwia zmianę trybów wyświetlania na stronie.The first part of this code example is the user control that enables you to change display modes on the page. Aby uzyskać szczegółowe informacje na temat trybów wyświetlania i Opis kodu źródłowego w tej kontrolce, zobacz Przewodnik: zmienianie trybów wyświetlania na stronie składniki Web Part.For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Drugą częścią przykładu kodu jest strona sieci Web, która zawiera deklaratywne odwołanie do CatalogZone kontrolki.The second part of the code example is a Web page that contains a declarative reference to a CatalogZone control. W górnej części strony znajdują się dwie Register dyrektywy — jeden dla kontrolki użytkownika i jeden dla WebPart kontrolki niestandardowej.Near the top of the page are two Register directives--one for the user control, and one for the custom WebPart control. Zauważ, że poniżej <asp:WebPartZone> elementu znajduje się <asp: CatalogZone> element, który zawiera deklaratywne odwołania do WebPart kontrolki niestandardowej i Calendar kontrolki ASP.NET.Notice that below the <asp:WebPartZone> element is an <asp: CatalogZone> element that contains declarative references to the custom WebPart control, and to an ASP.NET Calendar control. Strefa zawiera również różne Tagi i właściwości ustawiane w celu określenia wyglądu i zachowania.The zone also has a variety of tags and properties set to determine its appearance and behavior. Między <script> tagami na stronie jest różny kod obsługi zdarzeń, z którego większość pokazuje różne zastosowania programistyczne CatalogZoneBase członków.Between the <script> tags in the page is a variety of event-handling code, most of which demonstrates the various programmatic uses of the CatalogZoneBase members.

<%@ page language="c#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenucs.ascx" %>
<%@ 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">
<script runat="server">

  WebPartManager manager;

  protected void WebPartManager1_DisplayModeChanged(object sender,
    WebPartDisplayModeEventArgs e)
  {
    if (e.OldDisplayMode.Name != "Catalog")
      Panel1.Visible = true;
    else
      Panel1.Visible = false;
  }
  
  // <snippet3>
  protected void Button1_Click(object sender, EventArgs e)
  {
    if (CatalogZone1.AddVerb.Enabled)
    {
      CatalogZone1.AddVerb.Enabled = false;
      CatalogZone1.CloseVerb.Enabled = false;
    }
    else
    {
      CatalogZone1.AddVerb.Enabled = true;
      CatalogZone1.CloseVerb.Enabled = true;
    }
  }
  // </snippet3>

  // <snippet4>
  protected void Button2_Click(object sender, EventArgs e)
  {
    Label1.Text = "<h3>CatalogPart List</h3>";
    foreach(CatalogPart part in CatalogZone1.CatalogParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet4>

  // <snippet5>
  protected void Button3_Click(object sender, EventArgs e)
  {
    CatalogZone1.SelectTargetZoneText = "Add to zone";
    CatalogZone1.EmptyZoneText = "Zone is empty";
    CatalogZone1.HeaderText = "My Updated Header";
    CatalogZone1.InstructionText = "My Updated Instructions";
  }
  // </snippet5>

  // <snippet6>
  protected void Button4_Click(object sender, EventArgs e)
  {
    Label1.Text = CatalogZone1.SelectedCatalogPartID;
  }
  // </snippet6>

  // <snippet7>
  protected void Button5_Click(object sender, EventArgs e)
  {
    CatalogZone1.PartLinkStyle.ForeColor = System.Drawing.Color.Red;
    CatalogZone1.SelectedPartLinkStyle.ForeColor = 
      System.Drawing.Color.Blue;
  }
  // </snippet7>

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>        
      </asp:webpartzone>
      <asp:CatalogZone ID="CatalogZone1" runat="server"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>
<%@ page language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuvb.ascx" %>
<%@ 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">
<script runat="server">


  Dim manager As WebPartManager


  Protected Sub WebPartManager1_DisplayModeChanged(ByVal sender _
    As Object, ByVal e As WebPartDisplayModeEventArgs)
    If e.OldDisplayMode.Name <> "Catalog" Then
      Panel1.Visible = True
    Else
      Panel1.Visible = False
    End If

  End Sub
   
  ' <snippet3>
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    If CatalogZone1.AddVerb.Enabled Then
      CatalogZone1.AddVerb.Enabled = False
      CatalogZone1.CloseVerb.Enabled = False
    Else
      CatalogZone1.AddVerb.Enabled = True
      CatalogZone1.CloseVerb.Enabled = True
    End If

  End Sub
  ' </snippet3>
  
  ' <snippet4>
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = "<h3>CatalogPart List</h3>"
    Dim part As CatalogPart
    For Each part In CatalogZone1.CatalogParts
      Label1.Text += part.ID + "<br />"
    Next part

  End Sub
  ' </snippet4>
  
  ' <snippet5>
  Protected Sub Button3_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.SelectTargetZoneText = "Add to zone"
    CatalogZone1.EmptyZoneText = "Zone is empty"
    CatalogZone1.HeaderText = "My Updated Header"
    CatalogZone1.InstructionText = "My Updated Instructions"
  End Sub
  ' </snippet5>
  
  ' <snippet6>
  Protected Sub Button4_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = CatalogZone1.SelectedCatalogPartID
  End Sub
  ' </snippet6>
  
  ' <snippet7>
  Protected Sub Button5_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.PartLinkStyle.ForeColor = _
      System.Drawing.Color.Red
    CatalogZone1.SelectedPartLinkStyle.ForeColor = _
      System.Drawing.Color.Blue
  End Sub
  ' </snippet7>
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>        
      </asp:webpartzone>
      <asp:CatalogZone ID="CatalogZone1" runat="server"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

Trzecią częścią przykładu kodu jest kontrolka niestandardowa WebPart o nazwie TextDisplayWebPart .The third part of the code example is the custom WebPart control named TextDisplayWebPart. Jest on zadeklarowany w strefie, a użytkownik końcowy może dodać go z katalogu do strony.It is declared within the zone, and an end user can add it from the catalog to the page. Aby przykład kodu był uruchamiany, należy skompilować ten kod źródłowy.For the code example to run, you must compile this source code. Można ją skompilować jawnie i umieścić zestaw w folderze bin witryny sieci Web lub w globalnej pamięci podręcznej zestawów.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Alternatywnie można umieścić kod źródłowy w folderze App_Code witryny, w którym będzie on dynamicznie kompilowany w czasie wykonywania.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. Aby zapoznać się z przykładami obu metod kompilowania, zobacz Przewodnik: Tworzenie i używanie niestandardowej kontrolki serwera sieci Web.For a demonstration of both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
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;
    Literal lineBreak;

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      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);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
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 _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      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)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

Należy pamiętać, że aby przykład kodu działał, istnieje ustawienie, które należy dodać do pliku Web.config, aby umożliwić eksportowanie składniki Web Part plików opisu.Note that for the code example to work, there is a setting you must add in the Web.config file to enable exporting Web Parts description files. Upewnij się, że plik Web.config znajduje się w tym samym katalogu, co strona sieci Web dla tego przykładowego kodu.Ensure that you have a Web.config file in the same directory as the Web page for this code example. Upewnij <system.web> się, że w sekcji istnieje <webParts> element z enableExport atrybutem ustawionym na true , tak jak w poniższym znaczniku.Within the <system.web> section, make sure there is a <webParts> element with an enableExport attribute set to true, as in the following markup.

<webParts enableExport="true">

...

</webParts>

Podczas ładowania strony w przeglądarce możesz wybrać pozycję katalog z listy rozwijanej, aby przełączyć się do trybu wyświetlania katalogu.When you load the page in a browser, you can select Catalog from the drop-down list box to switch to catalog display mode. Gdy wykaz jest widoczny, można zobaczyć dwie kontrolki serwera, które można dodać z wykazu do strony, a także zanotować w interfejsie użytkownika skutki deklaracyjnego i programistycznego zastosowania CatalogZoneBase elementów członkowskich klasy.When the catalog is visible, you can see the two server controls that can be added from the catalog to the page, and you can also note in the UI the effects of the declarative and programmatic uses of the CatalogZoneBase class members.

Uwagi

CatalogZoneBaseKlasa jest klasą bazową, która dziedziczy z ToolZone klasy.The CatalogZoneBase class is a base class that inherits from the ToolZone class. Zawiera podstawowy zestaw zachowań dla stref pochodnych.It provides a base set of behaviors for derived zones.

CatalogZoneBaseKlasa zapewnia unikatowy interfejs użytkownika, który umożliwia użytkownikom dodawanie WebPart kontrolek i innych formantów serwera do stron sieci Web.The CatalogZoneBase class provides a unique user interface (UI) that enables users to add WebPart controls and other server controls to Web pages. Formanty, które pochodzą z CatalogZoneBase klasy, takie jak CatalogZone , są kontrolkami rzeczywiście umieszczanymi na stronach sieci Web.Controls that derive from the CatalogZoneBase class, such as CatalogZone, are the controls actually placed on Web pages. Działają jako kontenery dla innych kontrolek, nazywanych CatalogPart kontrolkami, które tworzą listy formantów serwera, które użytkownicy mogą dodawać do strony.They act as containers for other controls, known as CatalogPart controls, that create lists of server controls for users to add to a page. Strefy pochodne od CatalogZoneBase klasy mogą być wyświetlane tylko wtedy, gdy strona znajduje się w trybie wyświetlania katalogu.Zones that derive from the CatalogZoneBase class can appear only when the page is in catalog display mode.

Uwaga

CatalogZoneBaseStrefa może zawierać tylko CatalogPart kontrolki i odwrotnie, CatalogPart formanty mogą znajdować się tylko w CatalogZoneBase strefach.A CatalogZoneBase zone can contain only CatalogPart controls, and conversely, CatalogPart controls can reside only in CatalogZoneBase zones.

Mechanizm dodawania formantów serwera do wykazu jest następującym zestawem trzech formantów, które pochodzą od CatalogPart klasy bazowej.The mechanism for adding server controls to a catalog is the following set of three controls that derive from the base CatalogPart class.

KontrolaControl OpisDescription
PageCatalogPart Zachowuje odwołania do kontrolek, które zostały zamknięte na stronie.Maintains references to controls that have been closed on a page. Te kontrolki można otworzyć ponownie (dodać z powrotem do strony) przez użytkowników.These controls can be reopened (added back to the page) by users.
DeclarativeCatalogPart Zawiera odwołania do formantów, które są zadeklarowane w wykazie składniki Web Part w adjustacji strony sieci Web.Contains references to controls that are declared in a Web Parts catalog in the markup of a Web page. Te formanty mogą być dodawane do strony sieci Web przez użytkowników.These controls can be added to a Web page by users.
ImportCatalogPart Udostępnia interfejs użytkownika, który umożliwia użytkownikowi przekazanie pliku definicji do wykazu, aby można było dodać formant do strony sieci Web.Provides the UI for a user to upload a definition file to a catalog so that the control can be added to a Web page. Pliki definicji są plikami XML z rozszerzeniem. Rozszerzenie nazwy pliku WebPart, które importuje ustawienia dla kontrolki.Definition files are XML file with a .WebPart file name extension that import settings for a control. Aby można było zaimportować plik definicji, musi on znajdować się na serwerze.The control must be present on the server before the definition file can be imported.

CatalogZoneBaseKlasa ma wiele właściwości, które są przydatne do wyświetlania wykazów WebPart kontrolek.The CatalogZoneBase class has a number of properties that are useful for displaying catalogs of WebPart controls. AddVerbWłaściwość odwołuje się do zlecenia, które dodaje wybraną kontrolkę z wykazu do strony, natomiast CloseVerb Właściwość odwołuje się do zlecenia, które zamyka wykaz i zwraca tryb wyświetlania strony do trybu przeglądania.The AddVerb property references the verb that adds a selected control from the catalog to the page, while the CloseVerb property references a verb that closes the catalog and returns the page's display mode to browse mode. CatalogPartsWłaściwość odwołuje się do kolekcji wszystkich CatalogPart kontrolek w strefie.The CatalogParts property references the collection of all CatalogPart controls in the zone. Kilka właściwości zorientowanych na tekst, takich jak EmptyZoneText , HeaderText , i InstructionText Zastąp właściwości podstawowe w celu zapewnienia domyślnego tekstu właściwego dla wykazów.Several text-oriented properties, such as EmptyZoneText, HeaderText, and InstructionText, override base properties to provide default text appropriate for catalogs. SelectTargetZoneTextWłaściwość zawiera tekst obok kontrolki lista rozwijana, która umożliwia użytkownikom wybranie strefy, do której zostanie dodany formant.The SelectTargetZoneText property contains the text alongside the drop-down list control that allows users to choose which zone a control will be added to.

W klasie znajduje się kilka innych właściwości CatalogZoneBase .Several other properties are included in the CatalogZoneBase class. SelectedCatalogPartIDWłaściwość jest unikatowym identyfikatorem ciągu dla aktualnie zaznaczonej CatalogPart kontrolki.The SelectedCatalogPartID property is a unique string identifier for the currently selected CatalogPart control. ShowCatalogIconsWłaściwość wskazuje, czy wyświetlać ikony, które mogą być skojarzone z kontrolkami przez ustawienie CatalogIconImageUrl właściwości WebPart kontrolki.The ShowCatalogIcons property indicates whether to show the icons that can be associated with controls by setting the CatalogIconImageUrl property on a WebPart control.

PartLinkStyleWłaściwość zawiera atrybuty stylu dla linków do CatalogPart kontrolek, które nie są aktualnie wybrane w strefie.The PartLinkStyle property contains style attributes for the links to the CatalogPart controls that are not currently selected in the zone. Z kolei SelectedPartLinkStyle Właściwość zawiera atrybuty stylu łącza do CatalogPart kontrolki, która aktualnie została wybrana w strefie.In contrast, the SelectedPartLinkStyle property contains style attributes for a link to the CatalogPart control that the user has currently selected in the zone.

Oprócz właściwości istnieją również pewne metody CatalogZoneBase klasy, a także standardowe metody obsługi zdarzeń i renderowania dziedziczone z innych kontrolek podstawowych, które są jednoznacznie zaprojektowane do celów obsługi katalogów formantów.In addition to the properties, there are also some methods in the CatalogZoneBase class, in addition to the standard event-handling and rendering methods inherited from other base controls, which are uniquely designed for the purpose of handling catalogs of controls. CreateCatalogPartChromeMetoda tworzy Chrome (elementy interfejsu użytkownika zewnętrznego, takie jak obramowanie, czasowniki, ikony i tytuł) otaczające poszczególne CatalogPart kontrolki w strefie, a także obsługuje renderowanie formantów.The CreateCatalogPartChrome method creates the chrome (peripheral UI elements such as a border, verbs, icons, and a title) that surrounds each CatalogPart control in the zone, and also handles the rendering for the controls. CreateCatalogPartsMetoda jest metodą abstrakcyjną; klasy pochodne przesłaniają je w celu utworzenia wystąpień wszystkich CatalogPart kontrolek zawartych w strefie.The CreateCatalogParts method is an abstract method; derived classes override it to create instances of all the CatalogPart controls contained in the zone. InvalidateCatalogPartsMetoda może być wywoływana przez klasę pochodną, jeśli kolekcja CatalogPart kontrolek w strefie zmienia się z przyczyn programistycznych, a Klasa pochodna wymaga ponownego utworzenia kolekcji.The InvalidateCatalogParts method can be called by a derived class if the collection of CatalogPart controls in the zone changes for some programmatic reason, and the derived class needs to recreate the collection. LoadPostDataMetoda ładuje poprzednio istniejący stan dla pól wyboru obok WebPart kontrolek w wykazie, za każdym razem, gdy strona jest publikowana z powrotem na serwerze; odwrotnie SaveControlState Metoda zapisuje stan pól wyboru.The LoadPostData method loads the previously existing state for the check boxes next to the WebPart controls in the catalog, whenever the page is posted back to the server; conversely, the SaveControlState method saves the state of the check boxes. Na koniec RenderCatalogPartLinks Metoda zapewnia wszystkie renderowanie linków do poszczególnych CatalogPart kontrolek zawartych w strefie.Finally, the RenderCatalogPartLinks method provides all the rendering for the links to each CatalogPart control contained in the zone.

Uwagi dotyczące implementowania

Jeśli chcesz utworzyć strefę niestandardową na potrzeby CatalogPart kontroli hostingu, musisz określić, czy chcesz zapewnić obsługę szablonu strefy.If you want to develop a custom zone for hosting CatalogPart controls, you must determine whether you want to provide zone template support. Szablon strefy jest tworzony przez typy, które implementują ITemplate interfejs. jest to konieczne, jeśli chcesz umożliwić deweloperom stron korzystanie z strefy niestandardowej w celu odwoływania się do CatalogPart kontrolek w obrębie strefy przy użyciu deklaratywnego znacznika strony sieci Web.A zone template is created by types that implement the ITemplate interface, and is necessary if you want to enable page developers using your custom zone to reference CatalogPart controls within your zone in the declarative markup of a Web page. Jeśli potrzebna jest obsługa szablonu strefy, należy dziedziczyć z CatalogZone klasy.If you need zone template support, you should inherit from the CatalogZone class. Z kolei, jeśli strefa niestandardowa i jej kontrolki staną się niezależne CatalogPart i zostaną utworzone programowo bez żadnych opcji dla deweloperów stron, aby określić, że kontrolki w szablonie strefy można odziedziczyć bezpośrednio z CatalogZoneBase klasy.In contrast, if your custom zone and its CatalogPart controls are going to be self-contained, and they will be created programmatically without any options for page developers to specify controls declaratively in a zone template, then you can inherit directly from the CatalogZoneBase class. W przypadku dziedziczenia z CatalogZoneBase klasy należy zastąpić CreateCatalogParts() metodę i dodać WebPart do obiektu kontrolki lub inne formanty serwera, które mają być używane w katalogu CatalogPartCollection .If you inherit from the CatalogZoneBase class, you must override the CreateCatalogParts() method, and add the WebPart or other server controls you want in your catalog to a CatalogPartCollection object.

Konstruktory

CatalogZoneBase()

Inicjuje klasę do użycia przez wystąpienie klasy dziedziczonej.Initializes the class for use by an inherited class instance. Ten konstruktor może być wywoływany tylko przez dziedziczoną klasę.This constructor can only be called by an inherited class.

Właściwości

AccessKey

Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontrolki serwera sieci Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Odziedziczone po WebControl)
Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.Gets the browser-specific adapter for the control.

(Odziedziczone po Control)
AddVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym Dodawanie kontrolek z wykazu do strony składniki Web Part.Gets a reference to a WebPartVerb object that enables end users to add controls from a catalog to a Web Parts page.

AppRelativeTemplateSourceDirectory

Pobiera lub ustawia katalog wirtualny względem aplikacji Page lub UserControl obiekt, który zawiera tę kontrolkę.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Odziedziczone po Control)
AssociatedDisplayModes

Pobiera kolekcję WebPartDisplayMode obiektów, które są skojarzone z określoną ToolZone strefą.Gets the collection of WebPartDisplayMode objects that are associated with a particular ToolZone zone.

(Odziedziczone po ToolZone)
Attributes

Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Odziedziczone po WebControl)
BackColor

Pobiera lub ustawia kolor tła kontrolki serwera sieci Web.Gets or sets the background color of the Web server control.

(Odziedziczone po WebControl)
BackImageUrl

Pobiera lub ustawia adres URL obrazu tła dla strefy.Gets or sets the URL to a background image for a zone.

(Odziedziczone po WebZone)
BindingContainer

Pobiera formant, który zawiera powiązanie danych tego formantu.Gets the control that contains this control's data binding.

(Odziedziczone po Control)
BorderColor

Pobiera lub ustawia kolor obramowania kontrolki sieci Web.Gets or sets the border color of the Web control.

(Odziedziczone po WebControl)
BorderStyle

Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web.Gets or sets the border style of the Web server control.

(Odziedziczone po WebControl)
BorderWidth

Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web.Gets or sets the border width of the Web server control.

(Odziedziczone po WebControl)
CatalogPartChrome

Pobiera odwołanie do wystąpienia CatalogPartChrome klasy skojarzonej ze CatalogZoneBase strefą.Gets a reference to the instance of the CatalogPartChrome class associated with the CatalogZoneBase zone.

CatalogParts

Pobiera kolekcję wszystkich CatalogPart kontrolek zawartych w CatalogZoneBase strefie.Gets a collection of all the CatalogPart controls contained in a CatalogZoneBase zone.

ChildControlsCreated

Pobiera wartość wskazującą, czy zostały utworzone formanty podrzędne kontrolki serwera.Gets a value that indicates whether the server control's child controls have been created.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator formantu dla znacznika HTML, który jest generowany przez ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora używany we ClientID właściwości.Gets a character value representing the separator character used in the ClientID property.

(Odziedziczone po Control)
CloseVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym zamknięcie interfejsu użytkownika katalogu (UI) i przywrócenie strony do normalnego trybu przeglądania.Gets a reference to a WebPartVerb object that enables end users to close the catalog user interface (UI) and return the page to normal browse mode.

Context

Pobiera HttpContext obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.Gets the HttpContext object associated with the server control for the current Web request.

(Odziedziczone po Control)
Controls

Pobiera ControlCollection obiekt, który reprezentuje kontrolki podrzędne w obiekcie CompositeControl .Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Odziedziczone po CompositeControl)
ControlStyle

Pobiera styl kontrolki serwera sieci Web.Gets the style of the Web server control. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
ControlStyleCreated

Pobiera wartość wskazującą, czy Style obiekt został utworzony dla ControlStyle właściwości.Gets a value indicating whether a Style object has been created for the ControlStyle property. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is primarily used by control developers.

(Odziedziczone po WebControl)
CssClass

Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez formant serwera sieci Web na kliencie.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Odziedziczone po WebControl)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataItemContainer .Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataKeysControl .Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Odziedziczone po Control)
DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.Gets a value indicating whether a control is being used on a design surface.

(Odziedziczone po Control)
Display

Pobiera wartość wskazującą, czy ToolZone kontrolka jest aktualnie wyświetlana.Gets a value that indicates whether a ToolZone control is currently displayed.

(Odziedziczone po ToolZone)
EditUIStyle

Pobiera atrybuty stylu dla kontrolek edytowalnych zawartych w ToolZone kontrolce.Gets the style attributes for the editable controls contained in a ToolZone control.

(Odziedziczone po ToolZone)
EmptyZoneText

Pobiera lub ustawia komunikat wyświetlany, gdy strefa nie zawiera żadnych kontrolek.Gets or sets a message that appears when a zone contains no controls.

EmptyZoneTextStyle

Pobiera atrybuty stylu dla tekstu zastępczego w pustej strefie.Gets the style attributes for the placeholder text in an empty zone.

(Odziedziczone po WebZone)
Enabled

Pobiera lub ustawia wartość wskazującą, czy formant serwera sieci Web jest włączony.Gets or sets a value indicating whether the Web server control is enabled.

(Odziedziczone po WebControl)
EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy stosują się do tej kontrolki.Gets or sets a value indicating whether themes apply to this control.

(Odziedziczone po WebControl)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy formant serwera utrzymuje stan widoku, oraz stan widoku wszystkich formantów podrzędnych, które zawiera, do żądającego klienta.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Odziedziczone po Control)
ErrorStyle

Pobiera atrybuty stylu na potrzeby renderowania komunikatu o błędzie, który jest wyświetlany, jeśli WebPart nie można załadować ani utworzyć formantu.Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

(Odziedziczone po WebZone)
Events

Pobiera listę delegatów obsługi zdarzeń dla formantu.Gets a list of event handler delegates for the control. Ta właściwość jest tylko do odczytu.This property is read-only.

(Odziedziczone po Control)
Font

Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web.Gets the font properties associated with the Web server control.

(Odziedziczone po WebControl)
FooterStyle

Pobiera atrybuty stylu zawartości obszaru stopki strefy.Gets the style attributes for the contents of a zone's footer area.

(Odziedziczone po WebZone)
ForeColor

Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Odziedziczone po WebControl)
HasAttributes

Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty.Gets a value indicating whether the control has attributes set.

(Odziedziczone po WebControl)
HasChildViewState

Pobiera wartość wskazującą, czy bieżące kontrolki formantu serwera mają jakiekolwiek zapisane ustawienia stanu widoku.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Odziedziczone po Control)
HasFooter

Pobiera wartość wskazującą, czy strefa ma obszar stopki.Gets a value indicating whether a zone has a footer area.

(Odziedziczone po WebZone)
HasHeader

Pobiera wartość wskazującą, czy strefa ma obszar nagłówka.Gets a value indicating whether a zone has a header area.

(Odziedziczone po WebZone)
HeaderCloseVerb

Pobiera odwołanie do WebPartVerb obiektu w nagłówku ToolZone kontrolki, który jest używany do zamykania formantu.Gets a reference to the WebPartVerb object in the header of a ToolZone control that is used to close the control.

(Odziedziczone po ToolZone)
HeaderStyle

Pobiera atrybuty stylu zawartości obszaru nagłówka strefy.Gets the style attributes for the contents of a zone's header area.

(Odziedziczone po WebZone)
HeaderText

Pobiera lub ustawia tekst dla obszaru nagłówka strefy.Gets or sets the text for the header area of a zone.

HeaderVerbStyle

Pobiera atrybuty stylu dla wszystkich zleceń nagłówka wyświetlanych w ToolZone kontrolce.Gets the style attributes for all header verbs displayed in a ToolZone control.

(Odziedziczone po ToolZone)
Height

Pobiera lub ustawia wysokość kontrolki serwera sieci Web.Gets or sets the height of the Web server control.

(Odziedziczone po WebControl)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwerowej.Gets or sets the programmatic identifier assigned to the server control.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontroli.Gets the character used to separate control identifiers.

(Odziedziczone po Control)
InstructionText

Pobiera lub ustawia tekst w strefie, która udostępnia wskazówki dla użytkowników końcowych.Gets or sets the text in a zone that provides directions for end users.

InstructionTextStyle

Pobiera atrybuty stylu dla tekstu instrukcji, który pojawia się w górnej części ToolZone kontrolki.Gets the style attributes for the instruction text that appears at the top of a ToolZone control.

(Odziedziczone po ToolZone)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tym formancie mają stan kontroli.Gets a value indicating whether controls contained within this control have control state.

(Odziedziczone po Control)
IsEnabled

Pobiera wartość wskazującą, czy kontrolka jest włączona.Gets a value indicating whether the control is enabled.

(Odziedziczone po WebControl)
IsTrackingViewState

Pobiera wartość wskazującą, czy formant serwera zapisuje zmiany w stanie widoku.Gets a value that indicates whether the server control is saving changes to its view state.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy stan widoku jest włączony dla tego formantu.Gets a value indicating whether view state is enabled for this control.

(Odziedziczone po Control)
LabelStyle

Pobiera atrybuty stylu zawartości etykiet, które pojawiają się obok kontrolek edycji w ToolZone kontrolce.Gets the style attributes for the contents of the labels that appear alongside the editing controls within a ToolZone control. Formanty pochodne ToolZone , takie jak CatalogZone i EditorZone , stosują style do etykiet.The derived ToolZone controls, such as CatalogZone and EditorZone, apply the styles to the labels.

(Odziedziczone po ToolZone)
LoadViewStateByID

Pobiera wartość wskazującą, czy formant uczestniczy w ładowaniu stanu widoku przez ID zamianę na indeks.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazw kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera z tą samą ID wartością właściwości.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Odziedziczone po Control)
Padding

Pobiera lub ustawia atrybuty dopełnienia komórek w tabeli, która zawiera WebPart kontrolki w strefie.Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

(Odziedziczone po WebZone)
Page

Pobiera odwołanie do Page wystąpienia, które zawiera formant serwera.Gets a reference to the Page instance that contains the server control.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii formantów strony.Gets a reference to the server control's parent control in the page control hierarchy.

(Odziedziczone po Control)
PartChromePadding

Pobiera lub ustawia odległość między zawartością WebPart formantu a obramowaniem kontrolki.Gets or sets the distance between the contents of a WebPart control and the border of the control.

(Odziedziczone po WebZone)
PartChromeStyle

Pobiera charakterystyki stylu, które są stosowane do obramowań składniki Web Part kontrolek zawartych w strefie.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

(Odziedziczone po WebZone)
PartChromeType

Pobiera lub ustawia typ obramowania, który ramki składniki Web Part kontrolki zawarte w strefie.Gets or sets the type of border that frames Web Parts controls contained by a zone.

(Odziedziczone po WebZone)
PartLinkStyle

Pobiera obiekt, który zawiera atrybuty stylu dla CatalogPart kontrolek, które nie są aktualnie wybrane w strefie.Gets an object that contains style attributes for the CatalogPart controls that are not currently selected in the zone.

PartStyle

Pobiera charakterystyki stylu, które mają zastosowanie do obramowania i zawartości każdej kontrolki składniki Web Part zawartej w strefie.Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

(Odziedziczone po WebZone)
PartTitleStyle

Pobiera atrybuty stylu dla zawartości paska tytułu dla każdej kontrolki składniki Web Part zawartej w strefie.Gets style attributes for the title bar content for each Web Parts control contained by a zone.

(Odziedziczone po WebZone)
RenderClientScript

Pobiera wartość wskazującą, czy skrypt klienta ma być renderowany na stronie składniki Web Part.Gets a value that indicates whether to render client script on a Web Parts page.

(Odziedziczone po WebZone)
RenderingCompatibility

Pobiera wartość określającą ASP.NET wersję, która będzie zgodna z językiem HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Odziedziczone po Control)
SelectedCatalogPartID

Pobiera lub ustawia ciąg jako identyfikator aktualnie wybranej CatalogPart kontrolki w strefie.Gets or sets a string as an identifier for the currently selected CatalogPart control in a zone.

SelectedPartLinkStyle

Pobiera obiekt, który zawiera atrybuty stylu dla CatalogPart kontrolki, która jest aktualnie wybrana w strefie.Gets an object that contains style attributes for the CatalogPart control that is currently selected in the zone.

SelectTargetZoneText

Pobiera lub ustawia tekst obok kontrolki w interfejsie użytkownika katalogu (UI), który umożliwia użytkownikom wybranie strefy, do której mają zostać dodane wybrane kontrolki.Gets or sets the text alongside the control in the catalog user interface (UI) that allows users to choose which zone to add their selected controls to.

ShowCatalogIcons

Pobiera lub ustawia wartość wskazującą, czy kontrolki serwera w wykazie będą wyświetlały skojarzone z nimi ikony w wykazie.Gets or sets a value that indicates whether server controls in the catalog display their associated icons in the catalog.

Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę, gdy jest renderowany na powierzchni projektowej.Gets information about the container that hosts the current control when rendered on a design surface.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórkę, która ma zostać zastosowana do kontrolki.Gets or sets the skin to apply to the control.

(Odziedziczone po WebControl)
Style

Pobiera kolekcję atrybutów tekstu, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Odziedziczone po WebControl)
SupportsDisabledAttribute

Pobiera wartość wskazującą, czy formant powinien ustawić disabled atrybut renderowanego elementu HTML na "Disabled", gdy właściwość kontrolki IsEnabled ma wartość false .Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Odziedziczone po CompositeControl)
TabIndex

Pobiera lub ustawia indeks karty dla kontrolki serwer sieci Web.Gets or sets the tab index of the Web server control.

(Odziedziczone po WebControl)
TagKey

Pobiera HtmlTextWriterTag wartość odpowiadającą tej kontrolce serwera sieci Web.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebZone)
TagName

Pobiera nazwę tagu kontrolki.Gets the name of the control tag. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
TemplateControl

Pobiera lub ustawia odwołanie do szablonu, który zawiera tę kontrolkę.Gets or sets a reference to the template that contains this control.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny Page lub zawierający UserControl bieżącą kontrolkę serwerową.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Odziedziczone po Control)
ToolTip

Pobiera lub ustawia tekst wyświetlany, gdy wskaźnik myszy znajduje się nad kontrolką serwera sieci Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Odziedziczone po WebControl)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator dla kontrolki serwerowej.Gets the unique, hierarchically qualified identifier for the server control.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy formant sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Odziedziczone po Control)
VerbButtonType

Pobiera lub ustawia rodzaj przycisku używany do reprezentowania czasowników w strefie.Gets or sets what kind of button is used to represent verbs in a zone.

(Odziedziczone po WebZone)
VerbStyle

Pobiera atrybuty stylu dla zleceń interfejsu użytkownika (UI) skojarzonych z kontrolkami składniki Web Part w strefie.Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a zone.

(Odziedziczone po WebZone)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach na tej samej stronie.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy w StateBag obiekcie nie jest rozróżniana wielkość liter.Gets a value that indicates whether the StateBag object is case-insensitive.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb widoku stanu tego formantu.Gets or sets the view-state mode of this control.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako element interfejsu użytkownika na stronie.Gets or sets a value that indicates whether a server control is rendered as a user interface (UI) element on the page.

(Odziedziczone po ToolZone)
WebPartManager

Pobiera odwołanie do WebPartManager kontrolki skojarzonej z WebZone wystąpieniem formantu na stronie składniki Web Part.Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

(Odziedziczone po WebZone)
Width

Pobiera lub ustawia szerokość kontrolki serwera sieci Web.Gets or sets the width of the Web server control.

(Odziedziczone po WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)

Dodaje atrybuty HTML i style, które muszą być renderowane do określonego HtmlTextWriterTag .Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
AddedControl(Control, Int32)

Wywołuje się po dodaniu formantu podrzędnego do Controls kolekcji Control obiektu.Called after a child control is added to the Controls collection of the Control object.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia formant serwera o przeanalizowaniu elementu, XML lub HTML, a następnie dodaje element do obiektu formantu serwera ControlCollection .Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Odziedziczone po Control)
ApplyStyle(Style)

Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki sieci Web, zastępując wszelkie istniejące elementy stylu formantu.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Ta metoda jest używana głównie przez deweloperów kontroli.This method is primarily used by control developers.

(Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.Applies the style properties defined in the page style sheet to the control.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.Begins design-time tracing of rendering data.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o formancie serwera i dostarcza go do Trace właściwości, która będzie wyświetlana po włączeniu śledzenia dla strony.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość w pamięci podręcznej ClientID na null .Sets the cached ClientID value to null.

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie formantu dla kontrolek podrzędnych kontrolki serwerowej.Deletes the control-state information for the server control's child controls.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i kontroli dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state and control-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

Ustawia ClientIDMode Właściwość bieżącego wystąpienia kontrolki i wszystkich formantów podrzędnych na Inherit .Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Odziedziczone po Control)
Close()

Przełącza stronę sieci Web z trybu wyświetlania wykazu do normalnego trybu przeglądania.Switches the Web page from catalog display mode to normal browse mode.

CopyBaseAttributes(WebControl)

Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z której ta metoda jest wywoływana.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
CreateCatalogPartChrome()

Tworzy wystąpienie CatalogPartChrome obiektu używane do renderowania elementów interfejsu użytkownika zewnętrznego dla CatalogPart kontrolek w strefie.Creates an instance of a CatalogPartChrome object used to render the peripheral user interface (UI) elements for CatalogPart controls in a zone.

CreateCatalogParts()

Dostarcza deklarację metody bazowej, która może przesłonić strefy pochodne w celu obsługi szczegółów tworzenia CatalogPart kontrolek zawartych w strefie.Provides a base method declaration that derived zones can override to handle the details of creating the CatalogPart controls contained in a zone.

CreateChildControls()

Tworzy zestaw formantów podrzędnych skojarzonych ze CatalogZoneBase strefą.Creates the set of child controls associated with a CatalogZoneBase zone.

CreateControlCollection()

Tworzy nowy ControlCollection obiekt do przechowywania formantów podrzędnych (zarówno literału, jak i serwera) formantu serwera.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Odziedziczone po Control)
CreateControlStyle()

Tworzy obiekt Style, który jest używany wewnętrznie przez WebControl klasę do implementowania wszystkich właściwości związanych z stylem.Creates the style object that is used internally by the WebControl class to implement all style related properties. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
DataBind()

Tworzy powiązanie źródła danych z CompositeControl i wszystkimi jego kontrolkami podrzędnymi.Binds a data source to the CompositeControl and all its child controls.

(Odziedziczone po CompositeControl)
DataBind(Boolean)

Tworzy powiązanie źródła danych z wywoływanym formantem serwera i wszystkimi jego kontrolkami podrzędnymi z opcją podniesienia poziomu DataBinding zdarzenia.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Odziedziczone po Control)
DataBindChildren()

Tworzy powiązanie źródła danych z kontrolkami podrzędnymi formantu serwera.Binds a data source to the server control's child controls.

(Odziedziczone po Control)
Dispose()

Umożliwia formantowi serwera przeprowadzenie końcowego oczyszczania przed jego zwolnieniem z pamięci.Enables a server control to perform final clean up before it is released from memory.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Przerywa śledzenie danych renderowania w czasie projektowania.Ends design-time tracing of rendering data.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy formant serwera zawiera kontrolki podrzędne.Determines whether the server control contains child controls. Jeśli tak nie jest, tworzy kontrolki podrzędne.If it does not, it creates child controls.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator dla kontrolek, które nie mają przypisanego identyfikatora.Creates an identifier for controls that do not have an identifier assigned.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określonym id parametrem.Searches the current naming container for a server control with the specified id parameter.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określoną id i liczbą całkowitą, która jest określona w pathOffset parametrze, który ułatwia wyszukiwanie.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Nie należy przesłaniać tej wersji FindControl metody.You should not override this version of the FindControl method.

(Odziedziczone po Control)
Focus()

Ustawia fokus wprowadzania dla kontrolki.Sets input focus to a control.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.Gets design-time data for a control.

(Odziedziczone po Control)
GetEffectiveChromeType(Part)

Zwraca rzeczywistą lub obowiązującą bieżącą PartChromeType wartość WebPart kontrolki, uwzględniając PartChromeType Właściwość strefy i bieżący tryb wyświetlania strony składniki Web Part.Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

(Odziedziczone po WebZone)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca przedznaczoną część UniqueID właściwości określonej kontrolki.Returns the prefixed portion of the UniqueID property of the specified control.

(Odziedziczone po Control)
HasControls()

Określa, czy formant serwera zawiera wszystkie kontrolki podrzędne.Determines if the server control contains any child controls.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą czy zdarzenia są rejestrowane dla kontrolki lub wszelkich formantów podrzędnych.Returns a value indicating whether events are registered for the control or any child controls.

(Odziedziczone po Control)
InvalidateCatalogParts()

Niszczy kolekcję CatalogPart formantów skojarzonych ze CatalogZoneBase strefą.Destroys the collection of CatalogPart controls associated with a CatalogZoneBase zone.

IsLiteralContent()

Określa, czy formant serwera przechowuje tylko zawartość literału.Determines if the server control holds only literal content.

(Odziedziczone po Control)
LoadControlState(Object)

Ładuje stan z poprzedniego żądania strony dla właściwości kontrolki, które powinny być przechowywane na stronach ogłaszania zwrotnego, nawet gdy stan widoku jest wyłączony na formancie.Loads the state from a previous page request for control properties that should persist across postbacks even when view state is disabled on the control.

LoadPostData(String, NameValueCollection)

Przetwarza stan pól wyboru, które odpowiadają WebPart kontrolkom w wykazie, gdy strona zostanie odesłana na serwer.Processes the state of the check boxes that correspond to the WebPart controls in the catalog, when the page is posted back to the server.

LoadViewState(Object)

Ładuje wcześniej zapisane informacje o stanie dla strefy.Loads previously saved state information for a zone.

MapPathSecure(String)

Pobiera ścieżkę fizyczną, do której jest mapowana ścieżka wirtualna (absolutna lub względna).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MergeStyle(Style)

Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki sieci Web, ale nie zastępuje żadnych istniejących elementów stylu formantu.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie dla formantu serwera jest przenoszone do hierarchii kontroli serwera interfejsu użytkownika strony.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Odziedziczone po Control)
OnDataBinding(EventArgs)

Podnosi DataBinding zdarzenie.Raises the DataBinding event.

(Odziedziczone po Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Dostarcza deklarację metody bazowej, którą ToolZone formanty pochodne mogą przesłonić, aby obsłużyć szczegóły zmiany trybów wyświetlania stron dla wyspecjalizowanej strefy.Provides a base method declaration that derived ToolZone controls can override to handle the details of changing page display modes for a specialized zone.

(Odziedziczone po ToolZone)
OnInit(EventArgs)

Rejestruje obiekt strony, aby strona wymagała stanu formantu.Registers the page object so that the page requires control state.

OnLoad(EventArgs)

Podnosi Load zdarzenie.Raises the Load event.

(Odziedziczone po Control)
OnPreRender(EventArgs)

Podnosi PreRender zdarzenie i rejestruje obiekt strony tak, aby wymagał ogłaszania zwrotnego.Raises the PreRender event and registers the page object so that it requires postbacks.

OnSelectedWebPartChanged(Object, WebPartEventArgs)

Dostarcza deklarację metody bazowej, którą ToolZone formanty pochodne mogą przesłonić, aby obsłużyć zdarzenie zmiany, która składniki Web Part kontrolka została wybrana w ramach wyspecjalizowanej strefy.Provides a base method declaration that derived ToolZone controls can override to handle the event of changing which Web Parts control is selected within a specialized zone.

(Odziedziczone po ToolZone)
OnUnload(EventArgs)

Podnosi Unload zdarzenie.Raises the Unload event.

(Odziedziczone po Control)
OpenFile(String)

Pobiera informacje Stream używane do odczytu pliku.Gets a Stream used to read a file.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i informacje do elementu nadrzędnego formantu.Assigns any sources of the event and its information to the control's parent.

(Odziedziczone po Control)
RaisePostBackEvent(String)

Wykonuje akcje skojarzone z jednym z zleceń strefy lub zgłasza zdarzenie z powrotem do serwera.Carries out the actions associated with one of the zone verbs, or raises an event that posts back to the server.

RecreateChildControls()

Ponownie tworzy kontrolki podrzędne w formancie pochodnym CompositeControl .Recreates the child controls in a control derived from CompositeControl.

(Odziedziczone po CompositeControl)
RemovedControl(Control)

Wywoływana po usunięciu formantu podrzędnego z Controls kolekcji Control obiektu.Called after a child control is removed from the Controls collection of the Control object.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Renderuje strefę do określonego HtmlTextWriter obiektu.Renders the zone to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Renderuje tag otwierającego HTML kontrolki Zone do określonego HtmlTextWriter obiektu.Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

(Odziedziczone po WebZone)
RenderBody(HtmlTextWriter)

Zastępuje metodę podstawową, aby renderować obszar treści strefy pochodnej z CatalogZoneBase klasy.Overrides the base method to render the body area of a zone derived from the CatalogZoneBase class.

RenderCatalogPartLinks(HtmlTextWriter)

Renderuje linki do poszczególnych CatalogPart kontrolek w CatalogZoneBase strefie.Renders the links to the individual CatalogPart controls in a CatalogZoneBase zone.

RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementu podrzędnego kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderContents(HtmlTextWriter)

Renderuje całą zawartość kontrolki strefy między początkowym i końcowym tagiem do określonego HtmlTextWriter obiektu.Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

(Odziedziczone po WebZone)
RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu i przechowuje informacje o śledzeniu dla kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu za pomocą podanego ControlAdapter obiektu.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Odziedziczone po Control)
RenderEndTag(HtmlTextWriter)

Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania.Renders the HTML closing tag of the control into the specified writer. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
RenderFooter(HtmlTextWriter)

Renderuje obszar stopki dla CatalogZoneBase strefy.Renders the footer area for a CatalogZoneBase zone.

RenderHeader(HtmlTextWriter)

Przesłania metodę bazową w celu zapewnienia wyspecjalizowanego renderowania dla obszaru nagłówka wymaganego przez ToolZone kontrolki.Overrides the base method to provide specialized rendering for the header area required by ToolZone controls.

(Odziedziczone po ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Renderuje pojedyncze zlecenie z ToolZone kontrolką.Renders an individual verb with a ToolZone control.

(Odziedziczone po ToolZone)
RenderVerbs(HtmlTextWriter)

Renderuje czasowniki w obszarze stopce CatalogZoneBase strefy.Renders the verbs in the footer area of a CatalogZoneBase zone.

ResolveAdapter()

Pobiera adapter sterowania odpowiedzialny za renderowanie określonego formantu.Gets the control adapter responsible for rendering the specified control.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.Gets a URL that can be used by the browser.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na taki, który jest używany na żądającym klienta.Converts a URL into one that is usable on the requesting client.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany CatalogZoneBase stanu formantu, który występuje po opublikowaniu strony sieci Web na serwerze.Saves any changes in a CatalogZoneBase control's state that occur after the Web page is posted back to the server.

SaveViewState()

Zapisuje wszystkie zmiany stanu widoku, które wystąpiły po opublikowaniu strony na serwerze.Saves any view-state changes that have occurred after a page was posted back to the server.

SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.Sets design-time data for a control.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń, aby renderować formant serwera i jego zawartość w jego formancie nadrzędnym.Assigns an event handler delegate to render the server control and its content into its parent control.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TrackViewState()

Śledzi zmiany stanu widoku kontrolki strefy.Tracks changes to a zone control's view state.

Zdarzenia

DataBinding

Występuje, gdy formant serwera wiąże się ze źródłem danych.Occurs when the server control binds to a data source.

(Odziedziczone po Control)
Disposed

Występuje, gdy formant serwera zostanie wystawiony z pamięci, który jest ostatnim etapem cyklu życia formantu serwera, gdy zażądano strony ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Odziedziczone po Control)
Init

Występuje po zainicjowaniu formantu serwera, który jest pierwszym krokiem w jego cyklu życia.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest załadowana do Page obiektu.Occurs when the server control is loaded into the Page object.

(Odziedziczone po Control)
PreRender

Występuje po Control załadowaniu obiektu, ale przed renderowaniem.Occurs after the Control object is loaded but prior to rendering.

(Odziedziczone po Control)
Unload

Występuje, gdy formant serwera zostanie zwolniony z pamięci.Occurs when the server control is unloaded from memory.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)

Pobiera atrybut kontrolki sieci Web o podanej nazwie.Gets an attribute of the Web control with the specified name.

(Odziedziczone po WebControl)
IAttributeAccessor.SetAttribute(String, String)

Ustawia atrybut formantu sieci Web na określoną nazwę i wartość.Sets an attribute of the Web control to the specified name and value.

(Odziedziczone po WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Umożliwia projektantowi ponowne utworzenie kolekcji formantów podrzędnych kontrolki podrzędnej w środowisku czasu projektowania.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Odziedziczone po CompositeControl)
IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder .For a description of this member, see ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState() .For a description of this member, see GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary) .For a description of this member, see SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control) .For a description of this member, see SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData .For a description of this member, see UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings .For a description of this member, see DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings .For a description of this member, see HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions .For a description of this member, see Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions .For a description of this member, see HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object) .For a description of this member, see AddParsedSubObject(Object).

(Odziedziczone po Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Implementuje LoadPostData(String, NameValueCollection) metodę przez wywołanie LoadPostData(String, NameValueCollection) metody CatalogZoneBase klasy.Implements the LoadPostData(String, NameValueCollection) method by calling the LoadPostData(String, NameValueCollection) method of the CatalogZoneBase class.

IPostBackDataHandler.RaisePostDataChangedEvent()

Aby uzyskać opis tego elementu członkowskiego, zobacz RaisePostDataChangedEvent() .For a description of this member, see RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Implementuje RaisePostBackEvent(String) metodę.Implements the RaisePostBackEvent(String) method.

(Odziedziczone po ToolZone)

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonego formantu.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Zwraca obiekt obiektu z tabeli dla kontrolki zawierającej dane.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Pobiera metadane tabeli dla określonej kontrolki danych.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Ustawia metadane tabeli dla określonej kontrolki danych.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Ustawia metadane tabeli i mapowanie wartości domyślnej dla określonej kontrolki danych.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Ustawia metadane tabeli i mapowanie wartości domyślnej dla określonej kontrolki danych.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Określa, czy metadane tabeli są dostępne.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

Dotyczy

Zobacz też