PropertyGridEditorPart.Title プロパティ

.NET Framework クラス ライブラリ リファレンス

PropertyGridEditorPart.Title プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

エディタ コントロールのタイトルを取得または設定します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 Title As String

Visual Basic (使用法)

Dim instance As PropertyGridEditorPart
Dim value As String

value = instance.Title

instance.Title = value

C#

public override string Title { get;
 set; }

C++

public:
virtual property String^ Title {
    String^ get () override;
    void set (String^ value) override;
}

J#

/** @property */
public String get_Title ()

/** @property */
public void set_Title (String value)

JScript

public override function get
 Title () : String

public override function set
 Title (value : String)

プロパティ値
コントロールのタイトルとして使用される文字列。既定値は、Web パーツ コントロール セットによって提供される、算出されたコントロール名です。

解説

コントロールが編集モードで表示されている場合、Title プロパティ値が PropertyGridEditorPart コントロールのタイトル バーに表示されます。コントロールがページで宣言されている場合、Title 属性の値を設定できます。タイトルの値を指定しなかった場合は、カルチャ固有の既定値が指定されます。

Title プロパティは基本プロパティをオーバーライドするため、タイトルの値が指定されない場合は、Web パーツ コントロール セットによって PropertyGridEditorPart コントロールに適切な既定のタイトルが提供されます。

使用例

PropertyGridEditorPart コントロールの Title プロパティを使用する方法を次のコード例に示します。例の実行に必要なコード全体については、PropertyGridEditorPart クラスの概要のトピックで「例」を参照してください。

PropertyGridEditorPart コントロールのタイトルを Web ページで宣言して設定する方法を、次のコード例に示します。

Visual Basic

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

C#

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

コード例の次の部分は、Title プロパティの値をプログラムで設定する方法を示しています。プログラムで割り当てられた値を永続化するために editControlTitle という名前の静的変数が使用され、コントロールが初期化されるたびにこの値が Title プロパティに割り当てられます。これにより、この値が複数のポストバック イベントにわたって保持されます。

Visual Basic

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

C#

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

ブラウザでページを読み込む場合、[Display Mode] ドロップダウン リスト コントロールで [編集モード] を選択して、編集モードに切り替えることができます。User Information WebPart コントロールのタイトル バーで動詞メニュー (下向きの矢印) をクリックし、[編集] をクリックすることにより、コントロールを編集できます。編集ユーザー インターフェイス (UI) が表示状態の場合、PropertyGridEditorPart コントロールが表示され、ボタンおよびテキスト ボックスがその上に配置されます。PropertyGridEditorPart コントロールのタイトルは、Web ページの宣言型マークアップで割り当てられた値です。[Update EditorPart Title] ボタンの横のテキスト ボックスにテキストを入力してボタンをクリックすると、コントロールのタイトルが更新されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PropertyGridEditorPart クラス
PropertyGridEditorPart メンバ
System.Web.UI.WebControls.WebParts 名前空間
Part.Title プロパティ
その他の技術情報
ASP.NET Web パーツ ページ