WebZone クラス

定義

Web パーツ アプリケーションでサーバー コントロール (Web パーツ Part コントロール、サーバー コントロール、ユーザー コントロールを含む) のコンテナーとして機能するすべてのコントロールの基底クラスとなります。

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl
[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl
Public MustInherit Class WebZone
Inherits CompositeControl
継承
派生
属性

次のコード例では、 クラスの使用方法を WebZone 示します。

コード例の最初の部分は、 クラスから派生した 2 つのカスタム コントロールを WebPart 示しています。 コード例を実行するには、このソース コードをコンパイルする必要があります。 明示的にコンパイルし、結果のアセンブリを Web サイトの Bin フォルダーまたはグローバル アセンブリ キャッシュに配置できます。 または、ソース コードをサイトの App_Code フォルダーに配置して、実行時に動的にコンパイルすることもできます。 両方のコンパイル方法を示すチュートリアルについては、「 チュートリアル: カスタム Web サーバー コントロールの開発と使用」を参照してください。

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

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class CalendarWebPart : WebPart
  {
    Calendar _calendar;

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

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

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}
Imports System.Security.Permissions 
Imports System.Web
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 CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

コード例の 2 番目の部分は、コントロールをホストする Web ページを WebPart 示しています。 宣言型マークアップには、コントロールとコントロールの 2 つの WebPartZone コントロールが CatalogZone 含まれていることに EditorZone 注意してください。

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

ブラウザーでページを読み込み、さまざまなページ表示モードを切り替えて、さまざまなゾーンの動作を確認できます。 表示モードと、ユーザーが表示モードを切り替える方法の詳細については、「 チュートリアル: Web パーツ ページでの表示モードの変更」を参照してください。

注釈

Web パーツ ゾーンは、Web ページ上のサーバー コントロールを含む定義済みの領域であり、含まれているコントロールに対して一貫したユーザー インターフェイス (UI)、レイアウト、およびレンダリングを提供します。 ゾーンは HTML テーブルとしてブラウザーでレンダリングされます。

クラスは WebZone 、すべての Web パーツ ゾーンの基本クラスです。 ゾーン コントロールは、他のコントロールを格納するように設計された複合コントロールであるため、クラスは WebZone クラスから CompositeControl 継承されます。 WebPartManagerコントロールとPartコントロール (またはゾーンに配置できる他のユーザーまたはサーバー コントロール) と共に、基本クラスからWebZone派生したゾーン コントロールは、Web パーツ アプリケーションの重要な構成要素を形成します。

Web パーツ ゾーンの重要な役割は、含まれているコントロールに対して完全な Web パーツ機能を有効にすることです。 すべての Web パーツ ページには少なくとも 1 つのゾーンが含まれており、ゾーンには 0 個以上のパーツ コントロールを含めることができます。 Web パーツ機能にはゾーンが必要です。 ゾーンがない場合、クラスから WebPart 派生したコントロールであっても、Web パーツ機能がほとんどない場合があります。 逆に、Web パーツ コントロール セットの設計により、通常の ASP.NET コントロール、サーバー コントロール、またはユーザー コントロールを (からWebZone派生した) ゾーンにWebPartZoneBase配置できます。また、ゾーン内にあるため、これらの通常のサーバー コントロールは実行時にコントロールとしてWebPart機能できます。 詳細については、 クラスのドキュメントを GenericWebPart 参照してください。

注意

ゾーン外のページにコントロールを追加したり、コントロールを追加 Part したりできます WebPart が、その場合は通常のサーバー コントロールとして機能するだけです。

Web パーツ コントロール セットには 2 つの広範なカテゴリのゾーンがあり、そのすべてが基本 WebZone クラスから継承されます。

  • WebPartZoneBase ゾーン。 これには (およびその他のサーバーとユーザー) コントロールが含 WebPart まれており、ユーザーがほとんどの場合操作する Web パーツ ページのプライマリ UI を形成します。

  • ToolZone ゾーン。 これらのゾーンは、Web パーツ ページの特別なビューを提供します。これにより、ユーザーは Web パーツ ページ上のゾーンに含まれる WebPartZoneBase コントロールのコンテンツ、レイアウト、外観、動作、およびプロパティを変更 (カスタマイズ) できます。 たとえば、 CatalogZoneBase ゾーンは ToolZone 、ユーザーがサーバー コントロールを追加および削除できるように、ページのカタログ ビューを提供する です。 EditorZoneBaseゾーンは、ページの編集ビューを提供する別のToolZone種類であり、ユーザーはコントロールのプロパティ、外観、および動作と共にページのレイアウトを変更および編集できます。

Web パーツ コントロール セット内の各ゾーンには、 クラスから派生した対応する種類のコントロールが Part 含まれるように設計されており、パーツ コントロールはゾーンのメイン コンテンツおよびプライマリ UI として機能します。 Web パーツ コントロール セット内のゾーン型と、それに含まれるパーツ コントロールの対応する種類を次の表に示します。

パーツ コントロールの種類 ゾーンの種類
WebPart (および 実行時に でラップされるサーバーおよび GenericWebPart ユーザー コントロール) WebPartZone (基底クラスは です WebPartZoneBase )
EditorPart (Web パーツ コントロール セットにはいくつかの派生コントロールが用意されており、カスタム EditorPart コントロールを開発できます) EditorZone (基底クラスは です EditorZoneBase )
CatalogPart (Web パーツ コントロール セットにはいくつかの派生コントロールが用意されており、カスタム CatalogPart コントロールを開発できます) CatalogZone (基底クラスは です CatalogZoneBase )
WebPartConnection (接続コントロールは、基底クラスから継承されるパーツ コントロールではないという点で一意です) ConnectionsZone (から ToolZone 直接継承されます)

Web パーツ コントロール内のすべてのゾーンには、基本 WebZone クラスから継承される基本的で一般的なユーザー インターフェイス要素があります。 これらの要素がすべてすべてのゾーンに表示されるわけではありませんが、次の表で説明するように、各ゾーンの種類には、これらの共通のゾーン関連の UI 要素を含めることができます。

ゾーン セクション 説明
ヘッダー ゾーンの上部セクション。 これには、ゾーンのタイトルを含めることができるヘッダー テキストが含まれます。ヘッダーを区別するスタイル属性 (罫線や背景色など)。ユーザーがクリックしてゾーン全体に適用される UI アクション (ゾーンの閉じるなど) を実行できるゾーン レベルの動詞 (ボタン、ハイパーリンク、または画像で表されます)。 、、、 HeaderTextなどのHasHeaderHeaderStyleいくつかのWebZoneプロパティは、ゾーンのヘッダー領域に関連します。 ゾーンにゾーン レベルの動詞がある場合は、 VerbButtonType プロパティと VerbStyle プロパティがそれらに適用されます。 これら 2 つの動詞プロパティは、ゾーン レベルの動詞にのみ適用され、ゾーンに含まれる個々のパーツ コントロールの動詞には適用されないことに注意してください。 ヘッダーはすべての種類のゾーンに存在するわけではありません。通常、それらは、テキストと動詞を含む共通のヘッダー領域 (近い動詞など) を持つ必要があるゾーンに表示されます ToolZone
Body ゾーンのメイン コンテンツ セクション。 から WebZone 派生するすべてのゾーンには、body セクションがあります。 Web パーツ コントロール セット内のすべての種類のゾーンに対して、ゾーンの本体には、前の表に示すように、ゾーンの Part 種類に対応する指定された種類のコントロール (またはその他のサーバー コントロール) が含まれます。 クラスのさまざまなメンバーはWebZone、、、、および プロパティなど、body セクションの内容にPartChromeStyleBackImageUrlPartChromeType影響します。PartStyle body セクションが空の場合は、特定の EmptyZoneText 状況でメッセージを表示できます。
Chrome ゾーン内の各パーツ コントロールに対してレンダリングされる共通 UI 要素。 これは、ゾーン自体に適用されるスタイル属性の説明とは異なります。クロムは、包含パーツ コントロールに特に適用されます。 Chrome には、ゾーンのパーツ コントロールの動詞、罫線、その他のスタイル属性 (背景色、タイトル テキストのフォント スタイルなど) が含まれます。 ゾーンは、含まれるパーツ コントロールの種類に適した単一のクロム オブジェクト (コントロールを含む CatalogPart のオブジェクトなど) を使用して、CatalogPartChromeクロムの詳細をCatalogZone決定します。 この単一のクロム オブジェクトは、ゾーン内のすべてのパーツ コントロールのクロムの詳細とレンダリングを処理します。 これにより、開発者は、すべてのパーツ コントロールに対して一貫した一般的な外観を指定できるゾーンを作成できます。 ゾーンのパーツ コントロールのクロムに関連するいくつかのプロパティには、、PartChromeTypePartStyle、および PartTitleStyle プロパティがPartChromeStyle含まれます。 特定の種類のゾーンのクロム オブジェクトを参照する特定のプロパティを含む、ほとんどのクロム関連のプロパティは、基底 WebZone クラスには実装されないことに注意してください。 代わりに、ゾーンのクロム固有のほとんどの機能は、パーツ コントロールの固有のニーズに応じて、特定のゾーンの種類に実装されます。 このトピックの前の表に示した各ゾーンの種類のトピックを参照してください。
パーツ コントロール ゾーンの body セクションに存在するコントロール。 クラスから WebZone 継承するすべてのゾーンには、このトピックの前の表に示すように、対応する型の 1 つ以上のパーツ コントロールが本文セクションに含まれています。 これらのパーツ コントロールは、Web パーツ アプリケーションのメイン UI を形成します。 からWebZone派生するほとんどのゾーン型には、クラスの プロパティや EditorParts クラスの プロパティなどWebPartsWebPartZoneBase、含まれるすべてのパーツ コントロールを参照できるようにするコレクション プロパティEditorZoneBaseがあります。
フッター ゾーンの下部セクション。 ヘッダー セクションと同様に、すべての種類のゾーンに存在するわけではありませんが、通常はゾーンで ToolZone 発生します。 フッター セクションの一般的な内容は、ゾーンのフッター EditorZoneBase に表示される ok 動詞や apply 動詞などの動詞です。 フッター セクションに関連するいくつかのプロパティには、、FooterStyleHasFooterVerbButtonType、および プロパティがVerbStyle含まれます。

クラスの WebZone プロパティのほとんどは、ゾーンの一般的な UI 要素について説明する前の表で説明されています。 WebZoneクラスには、コンテンツのレンダリングの役割に関連するいくつかのメソッドもあります。 RenderContentsRenderBodyRenderFooter、および RenderHeader のすべてのメソッドをオーバーライドして、ゾーンの各特定のセクションのレンダリングをプログラムで制御できます。 たとえば、アプリケーション内のカタログ ゾーンのすべてのフッター セクションのレンダリングをカスタマイズする場合は、 クラスから継承し、 からCatalogZoneBaseWebZone継承されたメソッドをRenderFooterオーバーライドし、フッター セクションのレンダリングを変更できます。

注意 (実装者)

カスタム Web パーツ ゾーンを開発するために、 WebZone クラスから直接継承する必要はほとんどありません。 Web パーツ コントロール セットには、上記の「解説」セクションに記載されている特殊なゾーンが含まれています。通常は、いずれかのゾーンから派生して、カスタム動作をゾーンに追加できます。 クラスから WebZone 直接継承する場合は、いくつかのプロパティとメソッドをオーバーライドする必要があります (クラスのメンバーのドキュメントを WebZone 参照してください)。 また、カスタム WebPartManager コントロール、必要に応じてカスタム WebPartDisplayMode コントロールを作成して、ゾーンを表示する一意の表示モードを作成する必要があります。また、Web パーツ コントロール セット内でゾーンを動作させるには、その他のカスタマイズも行う必要があります。

プロパティ

AccessKey

Web サーバー コントロールにすばやく移動できるアクセス キーを取得または設定します。

(継承元 WebControl)
Adapter

コントロール用のブラウザー固有のアダプターを取得します。

(継承元 Control)
AppRelativeTemplateSourceDirectory

このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。

(継承元 Control)
Attributes

コントロールのプロパティに対応しない任意の属性 (表示専用) のコレクションを取得します。

(継承元 WebControl)
BackColor

Web サーバー コントロールの背景色を取得または設定します。

(継承元 WebControl)
BackImageUrl

ゾーンの背景イメージの URL を取得または設定します。

BindingContainer

このコントロールのデータ バインディングを格納しているコントロールを取得します。

(継承元 Control)
BorderColor

Web コントロールの境界線の色を取得または設定します。

(継承元 WebControl)
BorderStyle

Web サーバー コントロールの境界線スタイルを取得または設定します。

(継承元 WebControl)
BorderWidth

Web サーバー コントロールの境界線の幅を取得または設定します。

(継承元 WebControl)
ChildControlsCreated

サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。

(継承元 Control)
ClientID

ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。

(継承元 Control)
ClientIDMode

ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。

(継承元 Control)
ClientIDSeparator

ClientID プロパティで使用される区切り記号を表す文字値を取得します。

(継承元 Control)
Context

現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。

(継承元 Control)
Controls

ControlCollection 内の子コントロールを表す CompositeControl オブジェクトを取得します。

(継承元 CompositeControl)
ControlStyle

Web サーバー コントロールのスタイルを取得します。 このプロパティは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
ControlStyleCreated

Style オブジェクトが ControlStyle プロパティに対して作成されたかどうかを示す値を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
CssClass

クライアントで Web サーバー コントロールによって表示されるカスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。

(継承元 WebControl)
DataItemContainer

名前付けコンテナーが IDataItemContainer を実装している場合、名前付けコンテナーへの参照を取得します。

(継承元 Control)
DataKeysContainer

名前付けコンテナーが IDataKeysControl を実装している場合、名前付けコンテナーへの参照を取得します。

(継承元 Control)
DesignMode

コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。

(継承元 Control)
EmptyZoneText

ゾーンにコントロールが含まれないときに表示されるメッセージを取得または設定します。

EmptyZoneTextStyle

空のゾーン内のプレースホルダー テキストのスタイル属性を取得または設定します。

Enabled

Web サーバー コントロールを有効にするかどうかを示す値を取得または設定します。

(継承元 WebControl)
EnableTheming

テーマがこのコントロールに適用されるかどうかを示す値を取得または設定します。

(継承元 WebControl)
EnableViewState

要求元クライアントに対して、サーバー コントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。

(継承元 Control)
ErrorStyle

WebPart コントロールを読み込むことができない場合、または作成できない場合に表示されるエラー メッセージの表示のスタイル属性を取得します。

Events

コントロールのイベント ハンドラー デリゲートのリストを取得します。 このプロパティは読み取り専用です。

(継承元 Control)
Font

Web サーバー コントロールに関連付けられたフォント プロパティを取得します。

(継承元 WebControl)
FooterStyle

ゾーンのフッター領域の内容のスタイル属性を取得します。

ForeColor

Web サーバー コントロールの前景色 (通常はテキストの色) を取得または設定します。

(継承元 WebControl)
HasAttributes

コントロールに属性セットがあるかどうかを示す値を取得します。

(継承元 WebControl)
HasChildViewState

現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。

(継承元 Control)
HasFooter

ゾーンにフッター領域があるかどうかを示す値を取得します。

HasHeader

ゾーンにヘッダー領域があるかどうかを示す値を取得します。

HeaderStyle

ゾーンのヘッダー領域の内容のスタイル属性を取得します。

HeaderText

ゾーンのヘッダー領域のテキストを取得または設定します。

Height

Web サーバー コントロールの高さを取得または設定します。

(継承元 WebControl)
ID

サーバー コントロールに割り当てられたプログラム ID を取得または設定します。

(継承元 Control)
IdSeparator

コントロール ID を区別するために使用する文字を取得します。

(継承元 Control)
IsChildControlStateCleared

このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。

(継承元 Control)
IsEnabled

コントロールが有効かどうかを示す値を取得します。

(継承元 WebControl)
IsTrackingViewState

サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。

(継承元 Control)
IsViewStateEnabled

このコントロールでビューステートが有効かどうかを示す値を取得します。

(継承元 Control)
LoadViewStateByID

コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。

(継承元 Control)
NamingContainer

同じ ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナーへの参照を取得します。

(継承元 Control)
Padding

ゾーンで WebPart コントロールを含むテーブルのセル内のスペースに関する属性を取得または設定します。

Page

サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。

(継承元 Control)
Parent

ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。

(継承元 Control)
PartChromePadding

WebPart コントロールにおけるコンテンツと境界線との間隔を取得または設定します。

PartChromeStyle

ゾーンによって格納される Web パーツ コントロールの境界線に適用されるスタイル特性を取得します。

PartChromeType

ゾーンに含まれる Web パーツ コントロールの周囲を囲む境界線の種類を取得または設定します。

PartStyle

ゾーンに含まれる境界線および各 Web パーツ コントロールの内容に適用されるスタイル特性を取得します。

PartTitleStyle

ゾーンに含まれる各 Web パーツ コントロールのタイトル バーの内容のスタイル属性を取得します。

RenderClientScript

Web パーツ ページ上にクライアント スクリプトを表示するかどうかを示す値を取得します。

RenderingCompatibility

レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。

(継承元 Control)
Site

デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナーに関する情報を取得します。

(継承元 Control)
SkinID

コントロールに適用するスキンを取得または設定します。

(継承元 WebControl)
Style

Web サーバー コントロールの外側のタグにスタイル属性として表示されるテキスト属性のコレクションを取得します。

(継承元 WebControl)
SupportsDisabledAttribute

コントロールの disabled プロパティが IsEnabled の場合、レンダリングされた HTML 要素の false 属性を "無効" に設定するかどうかを示す値を取得します。

(継承元 CompositeControl)
TabIndex

Web サーバー コントロールのタブ インデックスを取得または設定します。

(継承元 WebControl)
TagKey

この Web サーバー コントロールに対応する HtmlTextWriterTag 値を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。

TagName

コントロール タグの名前を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
TemplateControl

このコントロールを格納しているテンプレートへの参照を取得または設定します。

(継承元 Control)
TemplateSourceDirectory

現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。

(継承元 Control)
ToolTip

マウス ポインターが Web サーバー コントロールの上を移動したときに表示されるテキストを取得または設定します。

(継承元 WebControl)
UniqueID

階層構造で修飾されたサーバー コントロールの一意の ID を取得します。

(継承元 Control)
ValidateRequestMode

ブラウザーからのクライアント入力の安全性をコントロールで調べるかどうかを示す値を取得または設定します。

(継承元 Control)
VerbButtonType

ゾーン内の動詞を表すために使用されるボタンの種類を取得または設定します。

VerbStyle

ゾーン内の Web パーツ コントロールに関連付けられたユーザー インターフェイス (UI) 動詞のスタイル属性を取得します。

ViewState

同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。

(継承元 Control)
ViewStateIgnoresCase

StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。

(継承元 Control)
ViewStateMode

このコントロールのビューステート モードを取得または設定します。

(継承元 Control)
Visible

サーバー コントロールがページ上の UI としてレンダリングされているかどうかを示す値を取得または設定します。

(継承元 Control)
WebPartManager

Web パーツ ページ上の WebPartManager コントロールのインスタンスに関連付けられた WebZone コントロールへの参照を取得します。

Width

Web サーバー コントロールの幅を取得または設定します。

(継承元 WebControl)

メソッド

AddAttributesToRender(HtmlTextWriter)

指定した HtmlTextWriterTag に表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
AddedControl(Control, Int32)

子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。

(継承元 Control)
AddParsedSubObject(Object)

XML または HTML のいずれかの要素が解析されたことをサーバー コントロールに通知し、サーバー コントロールの ControlCollection オブジェクトに要素を追加します。

(継承元 Control)
ApplyStyle(Style)

指定したスタイルの空白以外の要素を Web コントロールにコピーして、コントロールの既存のスタイル要素を上書きします。 このメソッドは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
ApplyStyleSheetSkin(Page)

ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。

(継承元 Control)
BeginRenderTracing(TextWriter, Object)

レンダリング データのデザイン時のトレースを開始します。

(継承元 Control)
BuildProfileTree(String, Boolean)

ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。

(継承元 Control)
ClearCachedClientID()

キャッシュされた ClientID 値を null に設定します。

(継承元 Control)
ClearChildControlState()

サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。

(継承元 Control)
ClearChildState()

サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。

(継承元 Control)
ClearChildViewState()

サーバー コントロールのすべての子コントロールのビューステート情報を削除します。

(継承元 Control)
ClearEffectiveClientIDMode()

現在のコントロール インスタンスおよびすべての子コントロールの ClientIDMode プロパティを Inherit に設定します。

(継承元 Control)
CopyBaseAttributes(WebControl)

指定した Web サーバー コントロールから、Style オブジェクトでカプセル化されていないプロパティをこのメソッドの呼び出し元の Web サーバー コントロールにコピーします。 このメソッドは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
CreateChildControls()

ASP.NET ページ フレームワークによって呼び出され、ポストバックまたはレンダリングの準備として、合成ベースの実装を使うサーバー コントロールに対し、それらのコントロールに含まれる子コントロールを作成するように通知します。

(継承元 Control)
CreateControlCollection()

サーバー コントロールの子コントロール (リテラルとサーバーの両方) を保持する新しい ControlCollection オブジェクトを作成します。

(継承元 Control)
CreateControlStyle()

WebControl クラスで、すべてのスタイル関連プロパティを実装するために内部的に使用されるスタイル オブジェクトを作成します。 このメソッドは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
DataBind()

CompositeControl およびそのすべての子コントロールにデータ ソースをバインドします。

(継承元 CompositeControl)
DataBind(Boolean)

DataBinding イベントを発生させるオプションを指定して、呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。

(継承元 Control)
DataBindChildren()

データ ソースをサーバー コントロールの子コントロールにバインドします。

(継承元 Control)
Dispose()

サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。

(継承元 Control)
EndRenderTracing(TextWriter, Object)

レンダリング データのデザイン時のトレースを終了します。

(継承元 Control)
EnsureChildControls()

サーバー コントロールに子コントロールが含まれているかどうかを確認します。 含まれていない場合、子コントロールを作成します。

(継承元 Control)
EnsureID()

ID が割り当てられていないコントロールの ID を作成します。

(継承元 Control)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
FindControl(String)

指定した id パラメーターを使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。

(継承元 Control)
FindControl(String, Int32)

指定した id および検索に役立つ pathOffset パラメーターに指定された整数を使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。 この形式の FindControl メソッドはオーバーライドしないでください。

(継承元 Control)
Focus()

コントロールに入力フォーカスを設定します。

(継承元 Control)
GetDesignModeState()

コントロールのデザイン時データを取得します。

(継承元 Control)
GetEffectiveChromeType(Part)

ゾーンの PartChromeType プロパティおよび Web パーツ ページの現在の表示モードが指定されると、WebPart コントロールの実際のまたは現在有効な PartChromeType の値を返します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetRouteUrl(Object)

ルート パラメーターのセットに対応する URL を取得します。

(継承元 Control)
GetRouteUrl(RouteValueDictionary)

ルート パラメーターのセットに対応する URL を取得します。

(継承元 Control)
GetRouteUrl(String, Object)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。

(継承元 Control)
GetRouteUrl(String, RouteValueDictionary)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。

(継承元 Control)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetUniqueIDRelativeTo(Control)

指定されたコントロールの UniqueID プロパティのプレフィックス部分を返します。

(継承元 Control)
HasControls()

サーバー コントロールに子コントロールが含まれているかどうかを確認します。

(継承元 Control)
HasEvents()

コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。

(継承元 Control)
IsLiteralContent()

サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。

(継承元 Control)
LoadControlState(Object)

SaveControlState() メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。

(継承元 Control)
LoadViewState(Object)

以前保存したゾーンの状態情報を読み込みます。

MapPathSecure(String)

仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。

(継承元 Control)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MergeStyle(Style)

指定したスタイルの空白以外の要素を Web コントロールにコピーしますが、コントロールの既存のスタイル要素は上書きしません。 このメソッドは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
OnBubbleEvent(Object, EventArgs)

サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。

(継承元 Control)
OnDataBinding(EventArgs)

DataBinding イベントを発生させます。

(継承元 Control)
OnInit(EventArgs)

Init イベントを発生させます。

OnLoad(EventArgs)

Load イベントを発生させます。

(継承元 Control)
OnPreRender(EventArgs)

PreRender イベントを発生させます。

OnUnload(EventArgs)

Unload イベントを発生させます。

(継承元 Control)
OpenFile(String)

ファイルの読み込みで使用される Stream を取得します。

(継承元 Control)
RaiseBubbleEvent(Object, EventArgs)

イベントのソースおよびその情報をコントロールの親に割り当てます。

(継承元 Control)
RecreateChildControls()

CompositeControl から派生したコントロール内に子コントロールを再作成します。

(継承元 CompositeControl)
RemovedControl(Control)

Control オブジェクトの Controls コレクションから子コントロールが削除された後に呼び出されます。

(継承元 Control)
Render(HtmlTextWriter)

クライアントに表示するために、指定した CompositeControl オブジェクトに HtmlTextWriter の内容を書き込みます。

(継承元 CompositeControl)
RenderBeginTag(HtmlTextWriter)

指定した HtmlTextWriter オブジェクトにゾーン コントロールの HTML の開始タグを出力します。

RenderBody(HtmlTextWriter)

ゾーン コントロールの本体の表示をオーバーライドします。

RenderChildren(HtmlTextWriter)

提供された HtmlTextWriter オブジェクトに対してサーバー コントロールの子のコンテンツを出力すると、クライアントで表示されるコンテンツが記述されます。

(継承元 Control)
RenderContents(HtmlTextWriter)

開始タグと終了タグの間のゾーン コントロールのすべての内容を、指定した HtmlTextWriter オブジェクトに出力します。

RenderControl(HtmlTextWriter)

指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。

(継承元 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。

(継承元 Control)
RenderEndTag(HtmlTextWriter)

コントロールの HTML 終了タグを指定したライターに表示します。 このメソッドは、主にコントロールの開発者によって使用されます。

(継承元 WebControl)
RenderFooter(HtmlTextWriter)

ゾーン コントロールのフッターの表示をオーバーライドします。

RenderHeader(HtmlTextWriter)

ゾーン コントロールのヘッダーの表示をオーバーライドします。

ResolveAdapter()

指定したコントロールを表示するコントロール アダプターを取得します。

(継承元 Control)
ResolveClientUrl(String)

ブラウザーで使用できる URL を取得します。

(継承元 Control)
ResolveUrl(String)

要求側クライアントで使用できる URL に変換します。

(継承元 Control)
SaveControlState()

ページがサーバーにポスト バックされた時間以降に発生したすべてのサーバー コントロール状態の変化を保存します。

(継承元 Control)
SaveViewState()

ページがサーバーにポスト バックされた後で発生したビューステートの変更を保存します。

SetDesignModeState(IDictionary)

コントロールのデザイン時データを設定します。

(継承元 Control)
SetRenderMethodDelegate(RenderMethod)

サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラー デリゲートを割り当てます。

(継承元 Control)
SetTraceData(Object, Object)

トレース データ キーとトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。

(継承元 Control)
SetTraceData(Object, Object, Object)

トレースされたオブジェクト、トレース データ キー、およびトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。

(継承元 Control)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TrackViewState()

ゾーン コントロールのビューステートの変更を追跡します。

イベント

DataBinding

サーバー コントロールがデータ ソースに連結すると発生します。

(継承元 Control)
Disposed

サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。

(継承元 Control)
Init

サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。

(継承元 Control)
Load

サーバー コントロールが Page オブジェクトに読み込まれると発生します。

(継承元 Control)
PreRender

Control オブジェクトの読み込み後、表示を開始する前に発生します。

(継承元 Control)
Unload

サーバー コントロールがメモリからアンロードされると発生します。

(継承元 Control)

明示的なインターフェイスの実装

IAttributeAccessor.GetAttribute(String)

指定された名前の Web コントロールの属性を取得します。

(継承元 WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web コントロールの属性を指定された名前と値に設定します。

(継承元 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

デザイナーが、デザイン時環境で子コントロールの複合コントロールのコレクションを再作成できるようにします。

(継承元 CompositeControl)
IControlBuilderAccessor.ControlBuilder

このメンバーの詳細については、「ControlBuilder」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.GetDesignModeState()

このメンバーの詳細については、「GetDesignModeState()」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

このメンバーの詳細については、「SetDesignModeState(IDictionary)」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

このメンバーの詳細については、「SetOwnerControl(Control)」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.UserData

このメンバーの詳細については、「UserData」をご覧ください。

(継承元 Control)
IDataBindingsAccessor.DataBindings

このメンバーの詳細については、「DataBindings」をご覧ください。

(継承元 Control)
IDataBindingsAccessor.HasDataBindings

このメンバーの詳細については、「HasDataBindings」をご覧ください。

(継承元 Control)
IExpressionsAccessor.Expressions

このメンバーの詳細については、「Expressions」をご覧ください。

(継承元 Control)
IExpressionsAccessor.HasExpressions

このメンバーの詳細については、「HasExpressions」をご覧ください。

(継承元 Control)
IParserAccessor.AddParsedSubObject(Object)

このメンバーの詳細については、「AddParsedSubObject(Object)」をご覧ください。

(継承元 Control)

拡張メソッド

FindDataSourceControl(Control)

指定されたコントロールのデータ コントロールに関連付けられているデータ ソースを返します。

FindFieldTemplate(Control, String)

指定されたコントロールの名前付けコンテナー内にある、指定された列のフィールド テンプレートを返します。

FindMetaTable(Control)

格納しているデータ コントロールのメタテーブル オブジェクトを返します。

GetDefaultValues(INamingContainer)

指定されたデータ コントロールの既定値のコレクションを取得します。

GetMetaTable(INamingContainer)

指定されたデータ コントロールのテーブル メタデータを取得します。

SetMetaTable(INamingContainer, MetaTable)

指定されたデータ コントロールのテーブル メタデータを設定します。

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

指定したデータ コントロールのテーブル メタデータおよび既定値のマッピングを設定します。

SetMetaTable(INamingContainer, MetaTable, Object)

指定したデータ コントロールのテーブル メタデータおよび既定値のマッピングを設定します。

TryGetMetaTable(INamingContainer, MetaTable)

テーブル メタデータが使用できるかどうかを判断します。

EnableDynamicData(INamingContainer, Type)

指定されたデータ コントロールの動的データの動作を有効にします。

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

指定されたデータ コントロールの動的データの動作を有効にします。

EnableDynamicData(INamingContainer, Type, Object)

指定されたデータ コントロールの動的データの動作を有効にします。

適用対象

こちらもご覧ください