PropertyGridEditorPart クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
関連付けられた WebPart またはサーバー コントロールのカスタム プロパティをエンド ユーザーが編集できるようにするエディター コントロールを提供します。 このクラスは継承できません。
public ref class PropertyGridEditorPart sealed : System::Web::UI::WebControls::WebParts::EditorPart
public sealed class PropertyGridEditorPart : System.Web.UI.WebControls.WebParts.EditorPart
type PropertyGridEditorPart = class
inherit EditorPart
Public NotInheritable Class PropertyGridEditorPart
Inherits EditorPart
- 継承
例
次のコード例では、Web ページでコントロールを PropertyGridEditorPart 宣言し、コントロールのいくつかの UI プロパティを編集できるようにする方法を WebPart 示します。 このコード例には、次の 4 つの部分があります。
Web パーツ ページの表示モードを変更できるユーザー コントロール。
コントロールとPropertyGridEditorPartコントロールを含む EditorZone Web ページと、カスタム WebPart コントロールへの参照。
カスタム WebPart コントロールを含むクラス。
ブラウザーでページを読み込む場合の例の動作の説明。
ユーザー コントロールのソース コードは、別のトピックから取得されます。 このコード例を機能させるには、「 チュートリアル: Web パーツ ページでの表示モードの変更 」トピックからユーザー コントロールの .ascx ファイルを取得し、このコード例の .aspx ページと同じフォルダーにファイルを配置する必要があります。
コード例の 2 番目の部分は Web ページです。 これには、コントロールへの宣言型参照と、コントロールへの EditorZone 宣言型参照を含む子 <zonetemplate>
要素が PropertyGridEditorPart 含まれます。 ページは、アセンブリの ディレクティブと <aspSample:UserInfoWebPart>
コントロールの 要素をRegister
使用して、カスタム WebPart コントロールを参照します。
<%@ page language="c#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="UserInfoWebPartCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
Button1.Visible = false;
TextBox1.Visible = false;
}
// <snippet3>
private static String editControlTitle;
protected void Button1_Click(object sender, EventArgs e)
{
editControlTitle = Server.HtmlEncode(TextBox1.Text);
PropertyGridEditorPart1.Title = editControlTitle;
}
protected void PropertyGridEditorPart1_Init(object sender, EventArgs e)
{
if (editControlTitle != null)
PropertyGridEditorPart1.Title = editControlTitle;
}
// </snippet3>
// <snippet4>
protected void PropertyGridEditorPart1_PreRender(object sender,
EventArgs e)
{
Button1.Visible = true;
TextBox1.Visible = true;
}
// </snippet4>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>
User Information WebPart with EditorPart
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server" >
<PartTitleStyle BorderWidth="1"
Font-Names="Verdana, Arial"
Font-Size="110%"
BackColor="LightBlue" />
<zonetemplate>
<aspSample:UserInfoWebPart
runat="server"
id="userinfo"
title = "User Information WebPart"
BackColor="Beige" />
</zonetemplate>
</asp:webpartzone>
<div>
<hr />
<asp:Button ID="Button1" runat="server"
Text="Update EditorPart Title"
OnClick="Button1_Click" />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
</div>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:PropertyGridEditorPart ID="PropertyGridEditorPart1"
runat="server"
Title="Edit Custom Properties"
OnPreRender="PropertyGridEditorPart1_PreRender"
OnInit="PropertyGridEditorPart1_Init" />
</ZoneTemplate>
</asp:EditorZone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="UserInfoWebPartVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs)
Button1.Visible = False
TextBox1.Visible = False
End Sub
' <snippet3>
Shared editControlTitle As String
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs)
editControlTitle = Server.HtmlEncode(TextBox1.Text)
PropertyGridEditorPart1.Title = editControlTitle
End Sub
Protected Sub PropertyGridEditorPart1_Init(ByVal _
sender As Object, ByVal e As System.EventArgs)
If Not editControlTitle Is Nothing Then
PropertyGridEditorPart1.Title = editControlTitle
End If
End Sub
' </snippet3>
' <snippet4>
Protected Sub PropertyGridEditorPart1_PreRender(ByVal _
sender As Object, ByVal e As System.EventArgs)
Button1.Visible = True
TextBox1.Visible = True
End Sub
' </snippet4>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>
User Information WebPart with EditorPart
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server" >
<PartTitleStyle BorderWidth="1"
Font-Names="Verdana, Arial"
Font-Size="110%"
BackColor="LightBlue" />
<zonetemplate>
<aspSample:UserInfoWebPart
runat="server"
id="userinfo"
title = "User Information WebPart"
BackColor="Beige" />
</zonetemplate>
</asp:webpartzone>
<div>
<hr />
<asp:Button ID="Button1" runat="server"
Text="Update EditorPart Title"
OnClick="Button1_Click" />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
</div>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:PropertyGridEditorPart ID="PropertyGridEditorPart1"
runat="server"
Title="Edit Custom Properties"
OnPreRender="PropertyGridEditorPart1_PreRender"
OnInit="PropertyGridEditorPart1_Init" />
</ZoneTemplate>
</asp:EditorZone>
</form>
</body>
</html>
コード例の 3 番目の部分は、 という名前UserInfoWebPart
のカスタム WebPart クラスで、Web ページで参照されます。 ユーザーに関する情報を含むさまざまなプロパティはすべて、 属性でマークされていることに WebBrowsable
注意してください。 これにより、コントロールは PropertyGridEditorPart 、これらのプロパティを編集するための UI を提供できます。 プロパティは属性で WebDisplayName
マークされ、編集 UI の各コントロールの横に表示されるラベルのテキストを指定します。
コード例を実行するには、このソース コードをコンパイルする必要があります。 明示的にコンパイルし、結果のアセンブリを Web サイトの Bin フォルダーまたはグローバル アセンブリ キャッシュに配置できます。 または、ソース コードをサイトの App_Code フォルダーに配置して、実行時に動的にコンパイルすることもできます。 コンパイル方法を示すチュートリアルについては、「 チュートリアル: カスタム Web サーバー コントロールの開発と使用」を参照してください。
重要
この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。
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 UserInfoWebPart : WebPart
{
HttpServerUtility server = HttpContext.Current.Server;
private String _userNickName = "Add a nickname.";
private String _userPetName = "Add a pet name.";
private DateTime _userSpecialDate = DateTime.Now;
private Boolean _userIsCurrent = true;
private JobTypeName _userJobType = JobTypeName.Unselected;
public enum JobTypeName
{
Unselected = 0,
Support = 1,
Service = 2,
Professional = 3,
Technical = 4,
Manager = 5,
Executive = 6
}
Label NickNameLabel;
Label PetNickNameLabel;
Label SpecialDateLabel;
CheckBox IsCurrentCheckBox;
Label JobTypeLabel;
// Add the Personalizable and WebBrowsable attributes to the
// public properties, so that users can save property values
// and edit them with a PropertyGridEditorPart control.
[Personalizable(), WebBrowsable, WebDisplayName("Nickname")]
public String NickName
{
get
{
object o = ViewState["NickName"];
if (o != null)
return (string)o;
else
return _userNickName;
}
set { _userNickName = server.HtmlEncode(value); }
}
[Personalizable(), WebBrowsable, WebDisplayName("Pet Name")]
public String PetName
{
get
{
object o = ViewState["PetName"];
if (o != null)
return (string)o;
else
return _userPetName;
}
set { _userPetName = server.HtmlEncode(value); }
}
[Personalizable(), WebBrowsable(), WebDisplayName("Special Day")]
public DateTime SpecialDay
{
get
{
object o = ViewState["SpecialDay"];
if (o != null)
return (DateTime)o;
else
return _userSpecialDate;
}
set { _userSpecialDate = value; }
}
[Personalizable(), WebBrowsable(), WebDisplayName("Job Type"),
WebDescription("Select the category that corresponds to your job.")]
public JobTypeName UserJobType
{
get
{
object o = ViewState["UserJobType"];
if (o != null)
return (JobTypeName)o;
else
return _userJobType;
}
set { _userJobType = (JobTypeName)value; }
}
[Personalizable(), WebBrowsable(), WebDisplayName("Is Current")]
public Boolean IsCurrent
{
get
{
object o = ViewState["IsCurrent"];
if (o != null)
return (Boolean)o;
else
return _userIsCurrent;
}
set { _userIsCurrent = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
NickNameLabel = new Label();
NickNameLabel.Text = this.NickName;
SetControlAttributes(NickNameLabel);
PetNickNameLabel = new Label();
PetNickNameLabel.Text = this.PetName;
SetControlAttributes(PetNickNameLabel);
SpecialDateLabel = new Label();
SpecialDateLabel.Text = this.SpecialDay.ToShortDateString();
SetControlAttributes(SpecialDateLabel);
IsCurrentCheckBox = new CheckBox();
IsCurrentCheckBox.Checked = this.IsCurrent;
SetControlAttributes(IsCurrentCheckBox);
JobTypeLabel = new Label();
JobTypeLabel.Text = this.UserJobType.ToString();
SetControlAttributes(JobTypeLabel);
ChildControlsCreated = true;
}
private void SetControlAttributes(WebControl ctl)
{
ctl.BackColor = Color.White;
ctl.BorderWidth = 1;
ctl.Width = 200;
this.Controls.Add(ctl);
}
protected override void RenderContents(HtmlTextWriter writer)
{
writer.Write("Nickname:");
writer.WriteBreak();
NickNameLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Pet Name:");
writer.WriteBreak();
PetNickNameLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Special Date:");
writer.WriteBreak();
SpecialDateLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Job Type:");
writer.WriteBreak();
JobTypeLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Current:");
writer.WriteBreak();
IsCurrentCheckBox.RenderControl(writer);
}
}
}
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 UserInfoWebPart
Inherits WebPart
Private server As HttpServerUtility = HttpContext.Current.Server
Private _userNickName As String = "Add a nickname."
Private _userPetName As String = "Add a pet name."
Private _userSpecialDate As DateTime = DateTime.Now
Private _userIsCurrent As [Boolean] = True
Private _userJobType As JobTypeName = JobTypeName.Unselected
Public Enum JobTypeName
Unselected = 0
Support = 1
Service = 2
Professional = 3
Technical = 4
Manager = 5
Executive = 6
End Enum
Private NickNameLabel As Label
Private PetNickNameLabel As Label
Private SpecialDateLabel As Label
Private IsCurrentCheckBox As CheckBox
Private JobTypeLabel As Label
' Add the Personalizable and WebBrowsable attributes to the
' public properties, so that users can save property values
' and edit them with a PropertyGridEditorPart control.
<Personalizable(), WebBrowsable(), WebDisplayName("Nickname")> _
Public Property NickName() As String
Get
Dim o As Object = ViewState("NickName")
If Not (o Is Nothing) Then
Return CStr(o)
Else
Return _userNickName
End If
End Get
Set(ByVal value As String)
_userNickName = server.HtmlEncode(value)
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Pet Name")> _
Public Property PetName() As String
Get
Dim o As Object = ViewState("PetName")
If Not (o Is Nothing) Then
Return CStr(o)
Else
Return _userPetName
End If
End Get
Set(ByVal value As String)
_userPetName = server.HtmlEncode(value)
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Special Day")> _
Public Property SpecialDay() As DateTime
Get
Dim o As Object = ViewState("SpecialDay")
If Not (o Is Nothing) Then
Return CType(o, DateTime)
Else
Return _userSpecialDate
End If
End Get
Set(ByVal value As DateTime)
_userSpecialDate = value
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Job Type"), _
WebDescription("Select the category that corresponds to your job.")> _
Public Property UserJobType() As JobTypeName
Get
Dim o As Object = ViewState("UserJobType")
If Not (o Is Nothing) Then
Return CType(o, JobTypeName)
Else
Return _userJobType
End If
End Get
Set(ByVal value As JobTypeName)
_userJobType = CType(value, JobTypeName)
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Is Current")> _
Public Property IsCurrent() As [Boolean]
Get
Dim o As Object = ViewState("IsCurrent")
If Not (o Is Nothing) Then
Return CType(o, [Boolean])
Else
Return _userIsCurrent
End If
End Get
Set(ByVal value As [Boolean])
_userIsCurrent = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
NickNameLabel = New Label()
NickNameLabel.Text = Me.NickName
SetControlAttributes(NickNameLabel)
PetNickNameLabel = New Label()
PetNickNameLabel.Text = Me.PetName
SetControlAttributes(PetNickNameLabel)
SpecialDateLabel = New Label()
SpecialDateLabel.Text = Me.SpecialDay.ToShortDateString()
SetControlAttributes(SpecialDateLabel)
IsCurrentCheckBox = New CheckBox()
IsCurrentCheckBox.Checked = Me.IsCurrent
SetControlAttributes(IsCurrentCheckBox)
JobTypeLabel = New Label()
JobTypeLabel.Text = Me.UserJobType.ToString()
SetControlAttributes(JobTypeLabel)
ChildControlsCreated = True
End Sub
Private Sub SetControlAttributes(ByVal ctl As WebControl)
ctl.BackColor = Color.White
ctl.BorderWidth = 1
ctl.Width = 200
Me.Controls.Add(ctl)
End Sub
Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
writer.Write("Nickname:")
writer.WriteBreak()
NickNameLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Pet Name:")
writer.WriteBreak()
PetNickNameLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Special Date:")
writer.WriteBreak()
SpecialDateLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Job Type:")
writer.WriteBreak()
JobTypeLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Current:")
writer.WriteBreak()
IsCurrentCheckBox.RenderControl(writer)
End Sub
End Class
End Namespace
ブラウザーでページを読み込むときは、[表示モード] ドロップダウン リスト コントロールで [編集モード] を選択して編集モードに切り替えます。
ユーザー情報 WebPart コントロールのタイトル バーで動詞メニュー (下向き矢印) をクリックし、[編集] をクリックしてコントロールを編集できます。 編集 UI が表示されると、コントロールが PropertyGridEditorPart 表示されます。 コントロールは、 プロパティの型に基づいて、 クラスの UserInfoWebPart
各プロパティに対してレンダリングされます。 編集 UI で変更を加えて [ 適用 ] ボタンをクリックすると、[ 表示モード ] ドロップダウン リストを使用して、ページを参照モードに戻し、編集変更の完全な効果を確認できます。
注釈
にはPropertyGridEditorPart、ユーザーがゾーンに配置された WebPartZoneBase および サーバー コントロールのWebPartカスタム プロパティを編集できる汎用ユーザー インターフェイス (UI) が用意されています。 これに対し、 コントロールや BehaviorEditorPart コントロールなどの他EditorPartのAppearanceEditorPartコントロールでは、 クラスからWebPart既存の UI 指向のプロパティのみを編集します。
Web パーツ コントロール セットにツール指向ゾーンがあるのと同様に (詳細については、クラスの概要を ToolZone 参照)、ツール指向のパーツ コントロールがあり、これらの各コントロールは対応する種類のツール ゾーンに存在する必要があります。 Web パーツ コントロール セット内のこれらの種類のコントロールには、次の 2 つの特徴があります。
これらは、エンド ユーザーが Web パーツ アプリケーションのページのプライマリ UI を形成するコントロールをカスタマイズできるようにするヘルパー コントロールです。
これらは、特定のページ表示モードでのみ表示されます。
コントロールは PropertyGridEditorPart 特別なコントロールであり、Web ページが編集モードの場合、および特定 WebPart のコントロールまたはサーバー コントロールがユーザーによって編集用に選択されている場合にのみ表示されます。 コントロールは PropertyGridEditorPart 、他 EditorPart のすべてのコントロールと同様に、ページ上の EditorZone ゾーンに存在する必要があります。
重要
ゾーンには EditorZone コントロールのみを EditorPart 含めることができます。また、 EditorPart コントロールを他の種類のゾーンに配置することはできません。
コントロールは PropertyGridEditorPart 、ソース コードで (クラスの) 属性を使用 WebBrowsable
してマークされたプロパティの編集 UI を WebBrowsableAttribute 提供します。 プロパティがこの属性でマークされている場合、 PropertyGridEditorPart コントロールはプロパティの型に基づいて編集 UI を作成し、必要に応じて オブジェクトを使用 PropertyDescriptor して各編集コントロールの値を プロパティの型に変換します。 また、編集 UI の表示に役立つ他の PropertyGridEditorPart 属性を追加することもできます。
WebDisplayName
(クラスのWebDisplayNameAttribute) 属性を使用すると、編集 UI の各コントロールに表示されるラベルのテキストを指定できます。
WebDescription
属性 (クラスからWebDescriptionAttribute) を使用すると、編集 UI の各コントロールのツールヒントとして表示される文字列を指定できます。
さまざまな型のプロパティを編集するために作成されたコントロールを次の表に示します。
プロパティの型 | プロパティを編集するために作成されたコントロール |
---|---|
String | TextBox |
Int、Float、Unit | TextBox |
ブール型 | CheckBox |
Enum | DropDownList (列挙値の一覧が含まれます) |
DateTime | TextBox |
PropertyGridEditorPartクラスには プロパティがありTitle、コントロールの表示タイトル テキストを取得または設定するために使用されます。 また、ページが編集モードになったときにコントロールを表示するかどうかを決定する、保護された Display プロパティもあります。
PropertyGridEditorPartクラスには、 ApplyChangesSyncChangesと という 2 つの重要なメソッドもあります。このメソッドは、 クラスからEditorPart継承され、オーバーライドされます。 メソッドは、エディター コントロールのフィールド値と編集中のコントロールのプロパティの間でプロパティ値を取得および設定できるため、非常に WebPart 重要です。
コントロールでは PropertyGridEditorPart カスタム プロパティのみを編集できるため、コントロールの外観、レイアウト、および動作を編集するには、Web パーツ コントロール セット内の他 EditorPart の WebPart コントロールが必要です。 その他のコントロールには、、 BehaviorEditorPart、 LayoutEditorPartおよび コントロールが AppearanceEditorPart 含まれます。 これらのコントロールは EditorPart 、コントロールの編集に必要なほとんどの編集 WebPart 機能を提供する必要がありますが、必要に応じて、 クラスから EditorPart 継承してカスタム エディター コントロールを作成することもできます。 コード例については、クラスの概要に関するトピックを EditorPart 参照してください。
注意
アクセシビリティを向上させるために、 PropertyGridEditorPart コントロールは 要素内に <fieldset>
レンダリングされます。 要素は <fieldset>
、コントロールの編集に PropertyGridEditorPart 使用される関連するコントロールのセットをグループ化し、ビジュアル ユーザー エージェント (通常の Web ブラウザーなど) と音声指向ユーザー エージェント (画面読み取りソフトウェアなど) の両方のコントロール間のタブナビゲーションを容易にします。
ユーザー補助
このコントロールに対して既定でレンダリングされるマークアップは、Web コンテンツ アクセシビリティ ガイドライン 1.0 (WCAG) 優先度 1 のガイドラインなどのアクセシビリティ標準に準拠していない可能性があります。 このコントロールのアクセシビリティサポートの詳細については、「 ASP.NET コントロールとアクセシビリティ」を参照してください。
コンストラクター
PropertyGridEditorPart() |
クラスの新しいインスタンスを作成します。 |
プロパティ
AccessKey |
Web サーバー コントロールにすばやく移動できるアクセス キーを取得または設定します。 (継承元 WebControl) |
Adapter |
コントロール用のブラウザー固有のアダプターを取得します。 (継承元 Control) |
AppRelativeTemplateSourceDirectory |
このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。 (継承元 Control) |
Attributes |
コントロールのプロパティに対応しない任意の属性 (表示専用) のコレクションを取得します。 (継承元 WebControl) |
BackColor |
Web サーバー コントロールの背景色を取得または設定します。 (継承元 WebControl) |
BackImageUrl |
パネル コントロールの背景イメージの URL を取得または設定します。 (継承元 Panel) |
BindingContainer |
このコントロールのデータ バインディングを格納しているコントロールを取得します。 (継承元 Control) |
BorderColor |
Web コントロールの境界線の色を取得または設定します。 (継承元 WebControl) |
BorderStyle |
Web サーバー コントロールの境界線スタイルを取得または設定します。 (継承元 WebControl) |
BorderWidth |
Web サーバー コントロールの境界線の幅を取得または設定します。 (継承元 WebControl) |
ChildControlsCreated |
サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。 (継承元 Control) |
ChromeState |
パーツ コントロールが最小化または標準のどちらの状態で表示されるかを示す値を取得または設定します。 (継承元 Part) |
ChromeType |
Web パーツ コントロールを囲む境界線の種類を取得または設定します。 (継承元 Part) |
ClientID |
ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。 (継承元 Control) |
ClientIDMode |
ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。 (継承元 Control) |
ClientIDSeparator |
ClientID プロパティで使用される区切り記号を表す文字値を取得します。 (継承元 Control) |
Context |
現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。 (継承元 Control) |
Controls |
ユーザー インターフェイスの階層構造の指定されたサーバー コントロールの子コントロールを格納している ControlCollection オブジェクトを取得します。 (継承元 Part) |
ControlStyle |
Web サーバー コントロールのスタイルを取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
ControlStyleCreated |
Style オブジェクトが ControlStyle プロパティに対して作成されたかどうかを示す値を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
CssClass |
クライアントで Web サーバー コントロールによって表示されるカスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。 (継承元 WebControl) |
DataItemContainer |
名前付けコンテナーが IDataItemContainer を実装している場合、名前付けコンテナーへの参照を取得します。 (継承元 Control) |
DataKeysContainer |
名前付けコンテナーが IDataKeysControl を実装している場合、名前付けコンテナーへの参照を取得します。 (継承元 Control) |
DefaultButton |
Panel コントロールから継承される基本プロパティをオーバーライドして、デザイナーにプロパティが表示されないようにし、テーマによる影響を受けないようにします。 |
Description |
パーツ コントロールのツールヒントやカタログで使用する、パーツ コントロールの動作をまとめた短い語句を取得または設定します。 (継承元 Part) |
DesignMode |
コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。 (継承元 Control) |
Direction |
テキストを含むコントロールを Panel コントロールに表示する方向を取得または設定します。 (継承元 Panel) |
Display |
コントロールを、それに関連付けられている WebPart コントロールが編集モードである場合に表示するかどうかを示す値を取得します。 |
DisplayTitle |
EditorPart コントロールのタイトル バーに表示されるタイトル テキストを含む文字列を取得します。 (継承元 EditorPart) |
Enabled |
Web サーバー コントロールを有効にするかどうかを示す値を取得または設定します。 (継承元 WebControl) |
EnableTheming |
テーマがこのコントロールに適用されるかどうかを示す値を取得または設定します。 (継承元 WebControl) |
EnableViewState |
要求元クライアントに対して、サーバー コントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。 (継承元 Control) |
Events |
コントロールのイベント ハンドラー デリゲートのリストを取得します。 このプロパティは読み取り専用です。 (継承元 Control) |
Font |
Web サーバー コントロールに関連付けられたフォント プロパティを取得します。 (継承元 WebControl) |
ForeColor |
Web サーバー コントロールの前景色 (通常はテキストの色) を取得または設定します。 (継承元 WebControl) |
GroupingText |
パネル コントロールに格納されているコントロールのグループのキャプションを取得または設定します。 (継承元 Panel) |
HasAttributes |
コントロールに属性セットがあるかどうかを示す値を取得します。 (継承元 WebControl) |
HasChildViewState |
現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。 (継承元 Control) |
Height |
Web サーバー コントロールの高さを取得または設定します。 (継承元 WebControl) |
HorizontalAlign |
パネルの内容の水平方向の配置を取得または設定します。 (継承元 Panel) |
ID |
サーバー コントロールに割り当てられたプログラム ID を取得または設定します。 (継承元 Control) |
IdSeparator |
コントロール ID を区別するために使用する文字を取得します。 (継承元 Control) |
IsChildControlStateCleared |
このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。 (継承元 Control) |
IsEnabled |
コントロールが有効かどうかを示す値を取得します。 (継承元 WebControl) |
IsTrackingViewState |
サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。 (継承元 Control) |
IsViewStateEnabled |
このコントロールでビューステートが有効かどうかを示す値を取得します。 (継承元 Control) |
LoadViewStateByID |
コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。 (継承元 Control) |
NamingContainer |
同じ ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナーへの参照を取得します。 (継承元 Control) |
Page |
サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。 (継承元 Control) |
Parent |
ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。 (継承元 Control) |
RenderingCompatibility |
レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。 (継承元 Control) |
ScrollBars |
Panel コントロールのスクロール バーの表示状態と位置を取得または設定します。 (継承元 Panel) |
Site |
デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナーに関する情報を取得します。 (継承元 Control) |
SkinID |
コントロールに適用するスキンを取得または設定します。 (継承元 WebControl) |
Style |
Web サーバー コントロールの外側のタグにスタイル属性として表示されるテキスト属性のコレクションを取得します。 (継承元 WebControl) |
SupportsDisabledAttribute |
コントロールの |
TabIndex |
Web サーバー コントロールのタブ インデックスを取得または設定します。 (継承元 WebControl) |
TagKey |
この Web サーバー コントロールに対応する HtmlTextWriterTag 値を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
TagName |
コントロール タグの名前を取得します。 このプロパティは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
TemplateControl |
このコントロールを格納しているテンプレートへの参照を取得または設定します。 (継承元 Control) |
TemplateSourceDirectory |
現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。 (継承元 Control) |
Title |
エディター コントロールのタイトルを取得または設定します。 |
ToolTip |
マウス ポインターが Web サーバー コントロールの上を移動したときに表示されるテキストを取得または設定します。 (継承元 WebControl) |
UniqueID |
階層構造で修飾されたサーバー コントロールの一意の ID を取得します。 (継承元 Control) |
ValidateRequestMode |
ブラウザーからのクライアント入力の安全性をコントロールで調べるかどうかを示す値を取得または設定します。 (継承元 Control) |
ViewState |
同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 (継承元 Control) |
ViewStateIgnoresCase |
StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。 (継承元 Control) |
ViewStateMode |
このコントロールのビューステート モードを取得または設定します。 (継承元 Control) |
Visible |
サーバー コントロールがページ上の UI としてレンダリングされているかどうかを示す値を取得または設定します。 (継承元 Control) |
WebPartManager |
現在の Web ページに関連付けられた WebPartManager コントロールへの参照を取得します。 (継承元 EditorPart) |
WebPartToEdit |
現在編集中の WebPart コントロールへの参照を取得します。 (継承元 EditorPart) |
Width |
Web サーバー コントロールの幅を取得または設定します。 (継承元 WebControl) |
Wrap |
パネルの内容をラップするかどうかを示す値を取得または設定します。 (継承元 Panel) |
Zone |
EditorZoneBase コントロールを格納している EditorPart ゾーンへの参照を取得します。 (継承元 EditorPart) |
メソッド
AddAttributesToRender(HtmlTextWriter) |
背景イメージ、配置、ラップ、および表示する属性のリストの方向に関する情報を追加します。 (継承元 Panel) |
AddedControl(Control, Int32) |
子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 (継承元 Control) |
AddParsedSubObject(Object) |
XML または HTML のいずれかの要素が解析されたことをサーバー コントロールに通知し、サーバー コントロールの ControlCollection オブジェクトに要素を追加します。 (継承元 Control) |
ApplyChanges() |
PropertyGridEditorPart コントロールの値を、関連付けられた WebPart コントロールの対応するプロパティに保存します。 |
ApplyStyle(Style) |
指定したスタイルの空白以外の要素を Web コントロールにコピーして、コントロールの既存のスタイル要素を上書きします。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
ApplyStyleSheetSkin(Page) |
ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。 (継承元 Control) |
BeginRenderTracing(TextWriter, Object) |
レンダリング データのデザイン時のトレースを開始します。 (継承元 Control) |
BuildProfileTree(String, Boolean) |
ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 (継承元 Control) |
ClearCachedClientID() |
キャッシュされた ClientID 値を |
ClearChildControlState() |
サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 (継承元 Control) |
ClearChildState() |
サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 (継承元 Control) |
ClearChildViewState() |
サーバー コントロールのすべての子コントロールのビューステート情報を削除します。 (継承元 Control) |
ClearEffectiveClientIDMode() |
現在のコントロール インスタンスおよびすべての子コントロールの ClientIDMode プロパティを Inherit に設定します。 (継承元 Control) |
CopyBaseAttributes(WebControl) |
指定した Web サーバー コントロールから、Style オブジェクトでカプセル化されていないプロパティをこのメソッドの呼び出し元の Web サーバー コントロールにコピーします。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
CreateChildControls() |
ASP.NET ページ フレームワークによって呼び出され、ポストバックまたはレンダリングの準備として、合成ベースの実装を使うサーバー コントロールに対し、それらのコントロールに含まれる子コントロールを作成するように通知します。 (継承元 Control) |
CreateControlCollection() |
サーバー コントロールの子コントロール (リテラルとサーバーの両方) を保持する新しい ControlCollection オブジェクトを作成します。 (継承元 Control) |
CreateControlStyle() |
すべてのスタイル関連プロパティを実装するために Panel コントロールが内部で使用するスタイル オブジェクトを作成します。 (継承元 Panel) |
DataBind() |
呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。 (継承元 Part) |
DataBind(Boolean) |
DataBinding イベントを発生させるオプションを指定して、呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。 (継承元 Control) |
DataBindChildren() |
データ ソースをサーバー コントロールの子コントロールにバインドします。 (継承元 Control) |
Dispose() |
サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。 (継承元 Control) |
EndRenderTracing(TextWriter, Object) |
レンダリング データのデザイン時のトレースを終了します。 (継承元 Control) |
EnsureChildControls() |
サーバー コントロールに子コントロールが含まれているかどうかを確認します。 含まれていない場合、子コントロールを作成します。 (継承元 Control) |
EnsureID() |
ID が割り当てられていないコントロールの ID を作成します。 (継承元 Control) |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
FindControl(String) |
指定した |
FindControl(String, Int32) |
指定した |
Focus() |
コントロールに入力フォーカスを設定します。 (継承元 Control) |
GetDesignModeState() |
EditorPart コントロールの親ゾーンの現在の状態を取得します。 (継承元 EditorPart) |
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) |
SaveViewState() メソッドで保存された前の要求からビュー ステート情報を復元します。 (継承元 WebControl) |
MapPathSecure(String) |
仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 (継承元 Control) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
MergeStyle(Style) |
指定したスタイルの空白以外の要素を Web コントロールにコピーしますが、コントロールの既存のスタイル要素は上書きしません。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
OnBubbleEvent(Object, EventArgs) |
サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。 (継承元 Control) |
OnDataBinding(EventArgs) |
DataBinding イベントを発生させます。 (継承元 Control) |
OnInit(EventArgs) |
Init イベントを発生させます。 (継承元 Control) |
OnLoad(EventArgs) |
Load イベントを発生させます。 (継承元 Control) |
OnPreRender(EventArgs) |
PreRender イベントを発生させます。 (継承元 EditorPart) |
OnUnload(EventArgs) |
Unload イベントを発生させます。 (継承元 Control) |
OpenFile(String) |
ファイルの読み込みで使用される Stream を取得します。 (継承元 Control) |
RaiseBubbleEvent(Object, EventArgs) |
イベントのソースおよびその情報をコントロールの親に割り当てます。 (継承元 Control) |
RemovedControl(Control) |
Control オブジェクトの Controls コレクションから子コントロールが削除された後に呼び出されます。 (継承元 Control) |
Render(HtmlTextWriter) |
指定された HTML ライターにコントロールを描画します。 (継承元 WebControl) |
RenderBeginTag(HtmlTextWriter) |
Panel コントロールの HTML 開始タグを指定したライターに表示します。 (継承元 Panel) |
RenderChildren(HtmlTextWriter) |
提供された HtmlTextWriter オブジェクトに対してサーバー コントロールの子のコンテンツを出力すると、クライアントで表示されるコンテンツが記述されます。 (継承元 Control) |
RenderContents(HtmlTextWriter) |
コントロールの内容を指定したライターに出力します。 このメソッドは、主にコントロールの開発者によって使用されます。 (継承元 WebControl) |
RenderControl(HtmlTextWriter) |
指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。 (継承元 Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。 (継承元 Control) |
RenderEndTag(HtmlTextWriter) |
Panel コントロールの HTML 終了タグを指定したライターに表示します。 (継承元 Panel) |
ResolveAdapter() |
指定したコントロールを表示するコントロール アダプターを取得します。 (継承元 Control) |
ResolveClientUrl(String) |
ブラウザーで使用できる URL を取得します。 (継承元 Control) |
ResolveUrl(String) |
要求側クライアントで使用できる URL に変換します。 (継承元 Control) |
SaveControlState() |
ページがサーバーにポスト バックされた時間以降に発生したすべてのサーバー コントロール状態の変化を保存します。 (継承元 Control) |
SaveViewState() |
TrackViewState() メソッドが呼び出された後に変更された状態を保存します。 (継承元 WebControl) |
SetDesignModeState(IDictionary) |
デザイン モード状態の特性を、EditorZoneBase コントロールを含む現在の EditorPart ゾーンに適用します。 (継承元 EditorPart) |
SetRenderMethodDelegate(RenderMethod) |
サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラー デリゲートを割り当てます。 (継承元 Control) |
SetTraceData(Object, Object) |
トレース データ キーとトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。 (継承元 Control) |
SetTraceData(Object, Object, Object) |
トレースされたオブジェクト、トレース データ キー、およびトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。 (継承元 Control) |
SyncChanges() |
WebPart コントロールから値を取得し、PropertyGridEditorPart コントロール内のこれらのプロパティ値を編集するために使用される、対応するコントロールを更新します。 |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
TrackViewState() |
コントロールでそのビュー ステートの変化を追跡して、その変化をオブジェクトの ViewState プロパティに保存できるようにします。 (継承元 WebControl) |
イベント
DataBinding |
サーバー コントロールがデータ ソースに連結すると発生します。 (継承元 Control) |
Disposed |
サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 (継承元 Control) |
Init |
サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 (継承元 Control) |
Load |
サーバー コントロールが Page オブジェクトに読み込まれると発生します。 (継承元 Control) |
PreRender |
Control オブジェクトの読み込み後、表示を開始する前に発生します。 (継承元 Control) |
Unload |
サーバー コントロールがメモリからアンロードされると発生します。 (継承元 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) |
指定されたデータ コントロールの動的データの動作を有効にします。 |
適用対象
こちらもご覧ください
.NET