WebPartZoneBase Klasa

Definicja

Służy jako klasa bazowa dla wszystkich kontrolek strefy, które działają jako kontenery dla WebPart kontrolek (lub innych serwerów lub użytkowników).

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

Przykłady

W poniższym przykładzie kodu pokazano użycie WebPartZoneBase klasy. Kod pokazuje, jak klasa pochodna , WebPartZonejest używana deklaratywnie na stronie składników Web Part do przechowywania WebPart kontrolek. Przykład kodu zawiera cztery sekcje: pierwsze trzy sekcje opisują pliki kodu, a czwarty wyjaśnia, jak uruchomić kod.

Pierwsza część przykładu kodu to kontrolka użytkownika, która umożliwia użytkownikom przełączanie strony do różnych trybów wyświetlania. Aby uzyskać więcej informacji na temat trybów wyświetlania składników Web Part i opisu kodu w tej kontrolce, zobacz Przewodnik: zmienianie trybów wyświetlania na stronie składników Web Part.

<%@ 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=" 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=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" />
    <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 plik obok kodu, który zawiera kod do obsługi zdarzeń dla głównej strony sieci Web. Kod w tym pliku pokazuje, jak pracować z niektórymi kluczowymi WebPartZoneBase elementami członkowskimi programowo.

using System;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class WebPartZoneBase_overview : System.Web.UI.Page
{
  protected void Page_Load(Object sender, EventArgs e)
  {
    Label1.Text = DateTime.Now.ToLongDateString();
    Label2.Text = String.Empty;
  }

  protected void Button1_Click(object sender, EventArgs e)
  {
    if (WebPartZone2.VerbButtonType == ButtonType.Button)
      WebPartZone2.VerbButtonType = ButtonType.Link;
    else
      WebPartZone2.VerbButtonType = ButtonType.Button;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    if (WebPartZone1.LayoutOrientation == Orientation.Vertical)
      WebPartZone1.LayoutOrientation = Orientation.Horizontal;
    else
      WebPartZone1.LayoutOrientation = Orientation.Vertical;
    Page_Load(sender, e);
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    StringBuilder builder = new StringBuilder();
    builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br />");
    foreach (WebPart part in WebPartZone1.WebParts)
    {
      builder.AppendLine("ID: " + part.ID 
                          + "; Type:  " + part.GetType() 
                          + @"<br />");
    }
    Label2.Text = builder.ToString();
    Label2.Visible = true;
  }

  protected void Button4_Click(object sender, EventArgs e)
  {
    StringBuilder builder = new StringBuilder();
    builder.AppendLine(@"<strong>WebPartZone1 DisplayTitle Property</strong><br />");
    builder.AppendLine(WebPartZone1.DisplayTitle + @"<br />");
    Label2.Text = builder.ToString();
    Label2.Visible = true;
  }
}
Imports System.Text
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Partial Public Class WebPartZoneBase_overview

  Inherits System.Web.UI.Page

  Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs) 
    Label1.Text = DateTime.Now.ToLongDateString()
    Label2.Text = String.Empty
  End Sub
  
  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) 
    If WebPartZone2.VerbButtonType = ButtonType.Button Then
        WebPartZone2.VerbButtonType = ButtonType.Link
    Else
        WebPartZone2.VerbButtonType = ButtonType.Button
    End If
  End Sub
 
  Protected Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs) 
    If WebPartZone1.LayoutOrientation = Orientation.Vertical Then
        WebPartZone1.LayoutOrientation = Orientation.Horizontal
    Else
        WebPartZone1.LayoutOrientation = Orientation.Vertical
    End If
    Page_Load(sender, e)
  End Sub 
  
  Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs) 
    Dim builder As New StringBuilder()
    builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br />")
    Dim part As WebPart
    For Each part In  WebPartZone1.WebParts
      builder.AppendLine("ID: " + part.ID + "; Type: " _
                          + part.GetType().ToString() _
                          + "<br />")
    Next part
    Label2.Text = builder.ToString()
    Label2.Visible = True
  End Sub 

  Protected Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim builder As New StringBuilder()
    builder.AppendLine("<strong>WebPartZone1 DisplayTitle Property</strong><br />")
    builder.AppendLine(WebPartZone1.DisplayTitle + "<br />")
    Label2.Text = builder.ToString()
    Label2.Visible = True
  End Sub

End Class

Trzecią częścią przykładu kodu jest strona sieci Web zawierająca WebPartZone kontrolki, które wykazują zachowanie z klasy bazowej WebPartZoneBase i WebPart kontrolki zawarte w strefach.

<%@ Page Language="C#" 
  Codefile="webpartzonebase_overview.cs"
  Inherits="WebPartZoneBase_overview"  %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>WebPartZoneBase Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" Runat="server" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <table width="75%">
        <tr>
          <td>
            <asp:WebPartZone 
              ID="WebPartZone1" 
              Runat="server"
              LayoutOrientation="Vertical" >
              <EditVerb Text="Edit WebPart" />
              <SelectedPartChromeStyle BackColor="LightBlue" />
              <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>
                <asp:Calendar ID="Calendar1" Runat="server" 
                  Title="My Calendar" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
          <td valign="top" align="right">
            <asp:WebPartZone 
              ID="WebPartZone2"
              Runat="server" 
              DragHighlightColor="#00ff00"
              AllowLayoutChange="true"
              EmptyZoneText="Add WebParts to this empty Zone."
              BorderWidth="2"
              BorderColor="DarkBlue"
              BorderStyle="Dashed" 
              MenuLabelText="Verbs Menu" 
              MenuPopupImageUrl="label.gif" >
              <VerbStyle Font-Italic="true" />
              <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
              <MenuLabelHoverStyle Font-Bold="true" />
              <MenuVerbHoverStyle BackColor="LightGrey" />
              <MenuVerbStyle Font-Italic="true" /> 
              <ZoneTemplate>
                <asp:Label ID="Label1" Runat="server" Title="Date" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
        </tr>
        <tr>
          <td>
            <asp:EditorZone ID="EditorZone1" Runat="server">
              <ZoneTemplate>
                <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
                  Runat="server" />
                <asp:LayoutEditorPart ID="LayoutEditorPart1" 
                  Runat="server" />
              </ZoneTemplate>
            </asp:EditorZone>      
          </td>
        </tr>
      </table>
    </div>
    <asp:Button ID="Button1" Runat="server" 
      Width="200" Text="Toggle WebPartZone2 Buttons" 
      OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" Runat="server" 
      Width="200"  Text="Toggle Layout Orientation" 
      OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" Runat="server" 
      Width="200" Text="List WebPartZone1 WebParts" 
      OnClick="Button3_Click" />
    <br />
    <asp:Button ID="Button4" Runat="server" 
      Width="200" Text="WebPartZone1 Display Title" 
      OnClick="Button4_Click" />
    <br />
    <asp:Label ID="Label2" Runat="server" Visible="false" />
    </form>
</body>
</html>
<%@ Page Language="VB" 
  Codefile="webpartzonebase_overview.vb"
  Inherits="WebPartZoneBase_overview"  %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>WebPartZoneBase Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" Runat="server" />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <table width="75%">
        <tr>
          <td>
            <asp:WebPartZone 
              ID="WebPartZone1" 
              Runat="server"
              LayoutOrientation="Vertical" >
              <EditVerb Text="Edit WebPart" />
              <SelectedPartChromeStyle BackColor="LightBlue" />
              <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>
                <asp:Calendar ID="Calendar1" Runat="server" 
                  Title="My Calendar" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
          <td valign="top" align="right">
            <asp:WebPartZone 
              ID="WebPartZone2"
              Runat="server" 
              DragHighlightColor="#00ff00"
              AllowLayoutChange="true"
              EmptyZoneText="Add WebParts to this empty Zone."
              BorderWidth="2"
              BorderColor="DarkBlue"
              BorderStyle="Dashed" 
              MenuLabelText="Verbs Menu" 
              MenuPopupImageUrl="label.gif" >
              <VerbStyle Font-Italic="true" />
              <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
              <MenuLabelHoverStyle Font-Bold="true" />
              <MenuVerbHoverStyle BackColor="LightGrey" />
              <MenuVerbStyle Font-Italic="true" /> 
              <ZoneTemplate>
                <asp:Label ID="Label1" Runat="server" Title="Date" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
        </tr>
        <tr>
          <td>
            <asp:EditorZone ID="EditorZone1" Runat="server">
              <ZoneTemplate>
                <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
                  Runat="server" />
                <asp:LayoutEditorPart ID="LayoutEditorPart1" 
                  Runat="server" />
              </ZoneTemplate>
            </asp:EditorZone>      
          </td>
        </tr>
      </table>
    </div>
    <asp:Button ID="Button1" Runat="server" 
      Width="200" Text="Toggle WebPartZone2 Buttons" 
      OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" Runat="server" 
      Width="200"  Text="Toggle Layout Orientation" 
      OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" Runat="server" 
      Width="200" Text="List WebPartZone1 WebParts" 
      OnClick="Button3_Click" />
    <br />
    <asp:Button ID="Button4" Runat="server" 
      Width="200" Text="WebPartZone1 Display Title" 
      OnClick="Button4_Click" />
    <br />
    <asp:Label ID="Label2" Runat="server" Visible="false" />
    </form>
</body>
</html>

Załaduj stronę internetową w przeglądarce. Użyj kontrolki listy rozwijanej Tryb wyświetlania , aby przełączyć stronę do trybu projektowania, kliknąć kontrolki WebPart i spróbować przeciągnąć je między widocznymi strefami. Kliknij niektóre przyciski na stronie, aby zobaczyć efekt użycia różnych składowych WebPartZoneBase klasy. Następnie przełącz stronę w tryb edycji. Upewnij się, że kontrolka WebPart jest umieszczona w WebPartZone2programie , kliknij menu czasowników na pasku tytułu kontrolki, a następnie kliknij przycisk Edytuj , aby edytować kontrolkę. Zakończ edytowanie tej kontrolki, a następnie edytuj jedną z kontrolek w innej strefie. Podczas wykonywania tych kroków zwróć uwagę na różnice w stylach interfejsu użytkownika kontrolek i stref, które są efektem używania różnych składowych WebPartZoneBase klasy.

Uwagi

W zestawie kontrolek składników Web Part strefa jest kontrolką złożoną renderowaną jako tabela HTML zawierającą inne kontrolki w zdefiniowanym regionie strony sieci Web. Klasa WebPartZoneBase jest strefą dziedziczą po klasie podstawowej WebZone i zapewnia podstawowy zestaw zachowań dla stref pochodnych, które zawierają WebPart kontrolki, kontrolki serwera i kontrolki użytkownika. Kombinacja WebPartZoneBase stref z kontrolkami (i innymi serwerami WebPart ) tworzy podstawowy interfejs użytkownika aplikacji składników Web Part, normalny widok strony, z którą użytkownicy korzystają przez większość czasu.

Wszystkie strefy udostępniają wspólny zestaw elementów interfejsu użytkownika dla kontrolek, które zawierają. Aby zapoznać się ze szczegółowym omówieniem elementów interfejsu użytkownika wspólnych dla wszystkich stref, zobacz temat omówienie klasy dla WebZone klasy. Strefa WebPartZoneBase zawiera sekcję treści zawierającą kontrolki serwera oraz skojarzony WebPartChrome obiekt używany do renderowania zawartych kontrolek i ich elementów chrome, takich jak czasowniki, obramowania itd.

Oprócz funkcji odziedziczonych po WebZone klasie klasa dodaje przeciąganie kontrolki po stronie klienta, określone czasowniki (aby włączyć typowe akcje interfejsu użytkownika, WebPartZoneBase takie jak minimalizowanie, zamykanie, usuwanie i edytowanie kontrolek) oraz dodatkowe funkcje stylu. Klasa WebPartZoneBase jest również klasą dziedziczą, jeśli chcesz zaprojektować strefę niestandardową opartą na bazie danych. Można na przykład utworzyć niestandardową strefę składników Web Part pogody dziedziczą z WebPartZoneBaseklasy i jest przeznaczona do zawierania i udostępniania funkcji układu oraz innych usług dla WebPart kontrolek powiązanych z danymi i wyświetlania informacji o pogodzie.

Klasa WebPartZoneBase zawiera wiele właściwości do pracy z atrybutami stylu w strefie. Istnieje kilka właściwości obramowania, w tym BorderStyle i BorderWidth. Istnieje grupa właściwości do pracy z atrybutami stylu menu, które mogą być wyświetlane w nagłówku strefy, takiej jak MenuLabelStyle, MenuVerbStylei inne.

Klasa WebPartZoneBase zawiera również wiele elementów członkowskich do obsługi czasowników w strefie. Te elementy członkowskie odnoszą się do czasowników wyświetlanych w kontrolkach części w strefie. Czasowniki na poziomie strefy można dodawać do WebPartZoneBase stref, ale domyślnie nie mają żadnych. Istnieje zestaw standardowych czasowników dostarczanych z zestawem kontrolek składników Web Part do użycia z kontrolkami części, a deweloperzy mogą również dodawać niestandardowe czasowniki. Niektóre ważne właściwości pracy z czasownikami obejmują właściwości odwołujące się do niektórych standardowych obiektów czasowników, takich jak CloseVerb, , DeleteVerbConnectVerb, i EditVerb, HelpVerbi MinimizeVerb. Standardowe czasowniki są wyświetlane w menu czasowników (zazwyczaj wyświetlane w interfejsie użytkownika jako menu rozwijane) na pasku tytułu każdej kontrolki zawartej w strefie. Istnieje również VerbButtonType właściwość, która umożliwia określenie typu obiektu możliwego do kliknięcia reprezentuje czasownik w interfejsie użytkownika.

Inne kluczowe elementy członkowskie do pracy z czasownikami to OnCreateVerbs metoda, która jest procedurą obsługi zdarzeń, którą można zastąpić w celu niestandardowej obsługi procesu tworzenia czasowników CreateVerbs i zdarzenia.

Klasa WebPartZoneBase zawiera szereg elementów członkowskich do pracy z kontrolkami WebPart zawartymi w strefie. Właściwość WebParts odwołuje się do kolekcji wszystkich WebPart kontrolek (i innych serwerów) w strefie. Kilka metod odpowiada standardowym czasownikom lub akcjom, które użytkownik może wykonywać na WebPart kontrolkach w strefie, takiej jak CloseWebPart, ConnectWebParti EditWebPart.

Istnieje również wiele elementów członkowskich w WebPartZoneBase klasie, które dotyczą sposobu WebPart rozmieszczenia lub rozmieszczania kontrolek w strefie. Właściwość AllowLayoutChange określa, czy kontrolki można przenosić między strefami, czy zmieniane w strefie przez użytkowników. Właściwość LayoutOrientation umożliwia określenie, czy kontrolki w strefie są rozmieszczone w poziomie lub w pionie.

Uwaga

Program Internet Explorer może renderować wysokość WebPartZone lub zawarte w nim kontrolki w nieoczekiwany sposób, w zależności od orientacji strefy. Aby uzyskać więcej informacji, zobacz dokumentację LayoutOrientation właściwości lub Height .

Inne metody w WebPartZoneBase klasie zapewniają szczegółową kontrolę programową nad renderowaniem różnych obszarów strefy. Wiele z tych metod zastępuje metody podstawowe dziedziczone z WebZone klasy, aby dostosować renderowanie dla stref zawierających WebPart kontrolki. Ważne metody obejmują Render, , RenderDropCueRenderBodyi RenderHeader.

Konstruktory

WebPartZoneBase()

Inicjuje klasę do użycia przez dziedziczone wystąpienie klasy. Ten konstruktor może być wywoływany tylko przez dziedziczonej klasy.

Właściwości

AccessKey

Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web.

(Odziedziczone po WebControl)
Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.

(Odziedziczone po Control)
AllowLayoutChange

Pobiera lub ustawia wartość wskazującą, czy układ WebPart kontrolek można zmienić w strefie.

AppRelativeTemplateSourceDirectory

Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę.

(Odziedziczone po Control)
Attributes

Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki.

(Odziedziczone po WebControl)
BackColor

Pobiera lub ustawia kolor tła kontrolki serwera sieci Web.

(Odziedziczone po WebControl)
BackImageUrl

Pobiera lub ustawia adres URL na obraz tła dla strefy.

(Odziedziczone po WebZone)
BindingContainer

Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki.

(Odziedziczone po Control)
BorderColor

Pobiera lub ustawia kolor obramowania kontrolki WebPartZoneBase .

BorderStyle

Pobiera lub ustawia rodzaj obramowania otaczającego kontrolkę WebPartZoneBase .

BorderWidth

Pobiera lub ustawia szerokość obramowania otaczającego kontrolkę WebPartZoneBase .

ChildControlsCreated

Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości .

(Odziedziczone po Control)
CloseVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym zamykanie WebPart kontrolek w strefie.

ConnectVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym tworzenie połączeń między kontrolkami WebPart .

Context

HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.

(Odziedziczone po Control)
Controls

ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne w obiekcie CompositeControl.

(Odziedziczone po CompositeControl)
ControlStyle

Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
ControlStyleCreated

Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości. Ta właściwość jest używana głównie przez deweloperów kontrolek.

(Odziedziczone po WebControl)
CssClass

Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie.

(Odziedziczone po WebControl)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement .

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement .

(Odziedziczone po Control)
DeleteVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym usuwanie WebPart kontrolek w strefie.

DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.

(Odziedziczone po Control)
DisplayTitle

Pobiera bieżącą wartość tekstu używanego jako tytuł WebPartZoneBase strefy, gdy sama strefa jest widoczna.

DragDropEnabled

Pobiera wartość wskazującą, czy WebPart kontrolki można przeciągać do strefy, czy z jej zejścia.

DragHighlightColor

Pobiera lub ustawia kolor wokół obramowania WebPartZoneBase strefy i jej regionów upuszczania, gdy użytkownik przeciąga kontrolkę.

EditVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym edytowanie WebPart kontrolek w strefie.

EmptyZoneText

Pobiera lub ustawia komunikat wyświetlany, gdy kontrolka WebPartZoneBase nie WebPart zawiera żadnych kontrolek.

EmptyZoneTextStyle

Pobiera atrybuty stylu tekstu zastępczego w pustej strefie.

(Odziedziczone po WebZone)
Enabled

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona.

(Odziedziczone po WebControl)
EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki.

(Odziedziczone po WebControl)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego.

(Odziedziczone po Control)
ErrorStyle

Pobiera atrybuty stylu do renderowania komunikatu o błędzie wyświetlanego, jeśli WebPart nie można załadować ani utworzyć kontrolki.

(Odziedziczone po WebZone)
Events

Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu.

(Odziedziczone po Control)
ExportVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym eksportowanie pliku definicji XML dla każdej WebPart kontrolki w strefie.

Font

Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web.

(Odziedziczone po WebControl)
FooterStyle

Pobiera atrybuty stylu zawartości obszaru stopki strefy.

(Odziedziczone po WebZone)
ForeColor

Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web.

(Odziedziczone po WebControl)
HasAttributes

Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty.

(Odziedziczone po WebControl)
HasChildViewState

Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku.

(Odziedziczone po Control)
HasFooter

Pobiera wartość wskazującą, czy strefa ma obszar stopki.

HasHeader

Pobiera wartość wskazującą, czy strefa ma obszar nagłówka.

HeaderStyle

Pobiera atrybuty stylu dla zawartości obszaru nagłówka strefy.

(Odziedziczone po WebZone)
HeaderText

Pobiera lub ustawia tekst dla obszaru nagłówka strefy.

(Odziedziczone po WebZone)
Height

Pobiera lub ustawia wysokość kontrolki serwera sieci Web.

(Odziedziczone po WebControl)
HelpVerb

Pobiera odwołanie do obiektu używanego WebPartVerb do uzyskiwania dostępu do zawartości Pomocy dla WebPart kontrolek w strefie.

ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontrolek.

(Odziedziczone po Control)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli.

(Odziedziczone po Control)
IsEnabled

Pobiera wartość wskazującą, czy kontrolka jest włączona.

(Odziedziczone po WebControl)
IsTrackingViewState

Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki.

(Odziedziczone po Control)
LayoutOrientation

Pobiera lub ustawia wartość wskazującą, czy kontrolki w strefie są rozmieszczone w pionie, czy w poziomie.

LoadViewStateByID

Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu.

(Odziedziczone po Control)
MenuCheckImageStyle

Pobiera atrybuty stylu, które są stosowane do obrazu znacznika wyboru wyświetlanego w menu czasowników obok zaznaczonego tekstu czasownika.

MenuCheckImageUrl

Pobiera lub ustawia adres URL obrazu używanego jako znacznik wyboru w menu czasowników każdej WebPart kontrolki w strefie.

MenuLabelHoverStyle

Pobiera atrybuty stylu stosowane do etykiety menu czasowników na pasku WebPart tytułu kontrolki, gdy użytkownik umieszcza wskaźnik myszy nad etykietą.

MenuLabelStyle

Pobiera informacje o stylu etykiety menu rozwijanego czasowników, które jest wyświetlane na pasku tytułu każdej WebPart kontrolki w strefie.

MenuLabelText

Pobiera lub ustawia wartość, która służy jako etykieta menu rozwijanego czasowników na pasku tytułu każdej WebPart kontrolki w strefie.

MenuPopupImageUrl

Pobiera lub ustawia adres URL obrazu, który otwiera menu rozwijane czasowników na pasku tytułu każdej WebPart kontrolki w strefie.

MenuPopupStyle

Pobiera atrybuty stylu dla menu zleceń rozwijanych, które jest wyświetlane w WebPart kontrolkach w strefie.

MenuVerbHoverStyle

Pobiera informacje o stylu dotyczące wyglądu czasownika w menu rozwijanym czasowników, gdy użytkownik końcowy umieszcza wskaźnik myszy nad zleceniem.

MenuVerbStyle

Pobiera informacje o stylu dotyczące wyglądu czasownika w menu rozwijanym czasowników po wyświetleniu menu.

MinimizeVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym zminimalizowanie WebPart kontrolek w strefie.

NamingContainer

Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości.

(Odziedziczone po Control)
Padding

Pobiera lub ustawia atrybuty wypełniania komórek w tabeli zawierającej kontrolki WebPart w strefie.

(Odziedziczone po WebZone)
Page

Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony.

(Odziedziczone po Control)
PartChromePadding

Pobiera lub ustawia odległość między zawartością WebPart kontrolki a obramowaniem kontrolki.

(Odziedziczone po WebZone)
PartChromeStyle

Pobiera cechy stylu, które mają zastosowanie do obramowań kontrolek składników Web Part zawartych w strefie.

(Odziedziczone po WebZone)
PartChromeType

Pobiera lub ustawia typ obramowania, który zawiera kontrolki Składników Web Part zawarte w strefie.

(Odziedziczone po WebZone)
PartStyle

Pobiera cechy stylu, które mają zastosowanie do obramowania i zawartości każdej kontrolki składników Web Part zawartej w strefie.

(Odziedziczone po WebZone)
PartTitleStyle

Pobiera atrybuty stylu zawartości paska tytułu dla każdej kontrolki składników Web Part zawartej w strefie.

(Odziedziczone po WebZone)
RenderClientScript

Pobiera wartość wskazującą, czy skrypt klienta ma być renderowany na stronie składników Web Part.

(Odziedziczone po WebZone)
RenderingCompatibility

Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny.

(Odziedziczone po Control)
RestoreVerb

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym przywracanie WebPart kontrolek w strefie do normalnego rozmiaru.

SelectedPartChromeStyle

Pobiera informacje o stylu dotyczące wyglądu wybranej WebPart kontrolki w strefie.

ShowTitleIcons

Pobiera lub ustawia wartość wskazującą, czy ikony tytułu są wyświetlane na pasku tytułu każdej WebPart kontrolki w strefie.

Site

Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórę do zastosowania do kontrolki.

(Odziedziczone po WebControl)
Style

Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web.

(Odziedziczone po WebControl)
SupportsDisabledAttribute

Pobiera wartość wskazującą, czy kontrolka powinna ustawić disabled atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled to false.

(Odziedziczone po CompositeControl)
TabIndex

Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web.

(Odziedziczone po WebControl)
TagKey

Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontroli serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebZone)
TagName

Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
TemplateControl

Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera.

(Odziedziczone po Control)
TitleBarVerbButtonType

Pobiera lub ustawia typ przycisku używanego dla czasowników na pasku WebPart tytułu kontrolek.

TitleBarVerbStyle

Pobiera atrybuty stylu dla czasowników na pasku tytułu kontrolki WebPart .

ToolTip

Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web.

(Odziedziczone po WebControl)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.

(Odziedziczone po Control)
VerbButtonType

Pobiera lub ustawia rodzaj przycisku skojarzonego z czasownikami istniejącymi w WebPartZoneBase strefie, gdy uzyskujesz dostęp do starszej przeglądarki.

VerbStyle

Pobiera atrybuty stylu dla czasowników interfejsu użytkownika skojarzonych z kontrolkami składników Web Part w strefie.

(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 dla tej samej strony.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb stanu widoku tej kontrolki.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie.

(Odziedziczone po Control)
WebPartChrome

Pobiera odwołanie do WebPartChrome obiektu, który określa renderowanie peryferyjne kontrolek WebPart w strefie.

WebPartManager

Pobiera odwołanie do kontrolki WebPartManager skojarzonej z wystąpieniem WebZone kontrolki na stronie składników Web Part.

(Odziedziczone po WebZone)
WebParts

Pobiera kolekcję kontrolek składników Web Part zawartych w strefie.

WebPartVerbRenderMode

Pobiera lub ustawia wartość wskazującą sposób renderowania czasowników dla WebPart kontrolek w strefie.

Width

Pobiera lub ustawia szerokość kontrolki serwera sieci Web.

(Odziedziczone po WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)

Dodaje atrybuty i style HTML, które muszą być renderowane do określonego HtmlTextWriterTagelementu . Ta metoda jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
AddedControl(Control, Int32)

Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera.

(Odziedziczone po Control)
ApplyStyle(Style)

Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek.

(Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie czasu projektowania danych renderowania.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość buforowanej ClientID na null.

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit.

(Odziedziczone po Control)
CloseWebPart(WebPart)

Zamyka wybraną WebPart kontrolkę w strefie.

ConnectWebPart(WebPart)

Inicjuje proces tworzenia połączenia między dwoma WebPart kontrolkami.

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órego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
CreateChildControls()

Tworzy zestaw kontrolek podrzędnych zawartych w strefie.

CreateControlCollection()

ControlCollection Tworzy obiekt zawierający wszystkie kontrolki w strefie.

CreateControlStyle()

Tworzy zestaw cech stylu, które mają zastosowanie do kontrolki strefy, gdy jest ona widoczna.

CreateWebPartChrome()

Umożliwia strefom pochodnym zastępowanie obiektu niestandardowego WebPartChrome w celu zmiany wyglądu WebPart kontrolek w strefie.

DataBind()

Wiąże źródło danych ze CompositeControl wszystkimi kontrolkami podrzędnymi i .

(Odziedziczone po CompositeControl)
DataBind(Boolean)

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding .

(Odziedziczone po Control)
DataBindChildren()

Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.

(Odziedziczone po Control)
DeleteWebPart(WebPart)

Usuwa wybraną WebPart kontrolkę w strefie.

Dispose()

Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.

(Odziedziczone po Control)
EditWebPart(WebPart)

Inicjuje proces edytowania wybranej WebPart kontrolki w strefie.

EndRenderTracing(TextWriter, Object)

Kończy śledzenie czasu projektowania danych renderowania.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , co ułatwia wyszukiwanie. Nie należy zastąpić tej wersji FindControl metody.

(Odziedziczone po Control)
Focus()

Ustawia fokus wejściowy na kontrolkę.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane w czasie projektowania dla kontrolki.

(Odziedziczone po Control)
GetEffectiveChromeType(Part)

Zwraca rzeczywistą lub efektywną bieżącą PartChromeTypeWebPart wartość kontrolki, biorąc pod uwagę PartChromeType właściwość strefy i bieżący tryb wyświetlania strony składników Web Part.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetInitialWebParts()

Pobiera początkową kolekcję WebPart kontrolek zawartych w strefie na podstawie szablonu lub nośnika magazynu.

GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.

(Odziedziczone po Control)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki.

(Odziedziczone po Control)
HasControls()

Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy kontrolka serwera zawiera tylko zawartość literału.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() .

(Odziedziczone po Control)
LoadViewState(Object)

Ładuje wcześniej zapisane informacje o stanie dla strefy.

MapPathSecure(String)

Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MergeStyle(Style)

Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
MinimizeWebPart(WebPart)

Minimalizuje wybraną WebPart kontrolkę w strefie.

OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.

(Odziedziczone po Control)
OnCreateVerbs(WebPartVerbsEventArgs)

CreateVerbs Zgłasza zdarzenie.

OnDataBinding(EventArgs)

DataBinding Zgłasza zdarzenie.

(Odziedziczone po Control)
OnInit(EventArgs)

Init Zgłasza zdarzenie.

(Odziedziczone po WebZone)
OnLoad(EventArgs)

Load Zgłasza zdarzenie.

(Odziedziczone po Control)
OnPreRender(EventArgs)

PreRender Zgłasza zdarzenie.

OnUnload(EventArgs)

Unload Zgłasza zdarzenie.

(Odziedziczone po Control)
OpenFile(String)

Stream Pobiera element używany do odczytywania pliku.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki.

(Odziedziczone po Control)
RaisePostBackEvent(String)

Aktualizacje stan bieżącej kolekcji WebPart kontrolek w strefie na podstawie zmian, które wystąpiły od ostatniego zdarzenia zwrotnego.

RecreateChildControls()

Odtwarza kontrolki podrzędne w kontrolce pochodzącej z CompositeControlklasy .

(Odziedziczone po CompositeControl)
RemovedControl(Control)

Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Renderuje strefę do określonego HtmlTextWriter obiektu.

RenderBeginTag(HtmlTextWriter)

Renderuje otwierający tag HTML kontrolki strefy do określonego HtmlTextWriter obiektu.

(Odziedziczone po WebZone)
RenderBody(HtmlTextWriter)

Zastępuje metodę podstawową, aby renderować obszar treści strefy pochodzącej WebPartZoneBase z klasy.

RenderChildren(HtmlTextWriter)

Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.

(Odziedziczone po Control)
RenderContents(HtmlTextWriter)

Renderuje całą zawartość kontrolki strefy między początkowymi i końcowymi tagami do określonego HtmlTextWriter obiektu.

(Odziedziczone po WebZone)
RenderControl(HtmlTextWriter)

Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu.

(Odziedziczone po Control)
RenderDropCue(HtmlTextWriter)

Renderuje elementy interfejsu użytkownika w celu wskazania użytkownikowi końcowemu, w którym WebPart można zrzucić kontrolkę przeciąganą w strefie.

RenderEndTag(HtmlTextWriter)

Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
RenderFooter(HtmlTextWriter)

Zastępuje renderowanie stopki kontrolki strefy.

(Odziedziczone po WebZone)
RenderHeader(HtmlTextWriter)

Zastępuje metodę podstawową w celu renderowania nagłówka strefy zawierającej WebPartZoneBaseWebPart kontrolki.

ResolveAdapter()

Pobiera kartę kontrolną odpowiedzialną za renderowanie określonej kontrolki.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na adres, który może być używany przez klienta żądającego.

(Odziedziczone po Control)
RestoreWebPart(WebPart)

Przywraca wybraną WebPart kontrolkę, która została zminimalizowana do normalnego stanu.

SaveControlState()

Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po Control)
SaveViewState()

Zapisuje wszelkie zmiany stanu widoku, które wystąpiły po opublikowaniu strony z powrotem na serwerze.

SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej.

(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.

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

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
TrackViewState()

Rozpoczyna proces śledzenia zmian stanu widoku w strefie, aby można było je przechowywać w StateBag obiekcie i uzyskiwać do nich dostęp za pośrednictwem ViewState właściwości.

Zdarzenia

CreateVerbs

Występuje, gdy czasowniki są tworzone dla strefy pochodzącej WebPartZoneBase z klasy.

DataBinding

Występuje, gdy kontrolka serwera wiąże się ze źródłem danych.

(Odziedziczone po Control)
Disposed

Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET.

(Odziedziczone po Control)
Init

Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest ładowana do Page obiektu.

(Odziedziczone po Control)
PreRender

Występuje po załadowaniu Control obiektu, ale przed renderowaniem.

(Odziedziczone po Control)
Unload

Występuje, gdy kontrolka serwera jest zwalniana z pamięci.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)

Pobiera atrybut kontrolki Sieci Web o określonej nazwie.

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

Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość.

(Odziedziczone po WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Umożliwia projektantowi ponowne utworzenie kolekcji kontrolek podrzędnych kontrolki złożonej w środowisku czasu projektowania.

(Odziedziczone po CompositeControl)
IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object).

(Odziedziczone po Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Aby uzyskać opis tego elementu członkowskiego, zobacz RaisePostBackEvent(String).

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.

FindMetaTable(Control)

Zwraca obiekt metatable dla kontrolki zawierającej dane.

GetDefaultValues(INamingContainer)

Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych.

GetMetaTable(INamingContainer)

Pobiera metadane tabeli dla określonej kontrolki danych.

SetMetaTable(INamingContainer, MetaTable)

Ustawia metadane tabeli dla określonej kontrolki danych.

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

Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych.

SetMetaTable(INamingContainer, MetaTable, Object)

Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych.

TryGetMetaTable(INamingContainer, MetaTable)

Określa, czy metadane tabeli są dostępne.

EnableDynamicData(INamingContainer, Type)

Włącza zachowanie danych dynamicznych dla określonej kontrolki danych.

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

Włącza zachowanie danych dynamicznych dla określonej kontrolki danych.

EnableDynamicData(INamingContainer, Type, Object)

Włącza zachowanie danych dynamicznych dla określonej kontrolki danych.

Dotyczy

Zobacz też