PropertyGridEditorPart.Title Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Legt einen Titel für das Editorsteuerelement fest oder ruft diesen ab.

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

public override string Title { get; set; }

member this.Title : string with get, set

Public Overrides Property Title As String

Eigenschaftswert

String

Eine Zeichenfolge, die als Titel des Steuerelements verwendet wird. Der Standardwert ist ein vom Webparts-Steuerelementsatz bereitgestellter berechneter Steuerelementname.

Beispiele

In diesem Codebeispiel wird veranschaulicht, wie die Title -Eigenschaft eines -Steuerelements PropertyGridEditorPart verwendet wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des PropertyGridEditorPart Themas Klassenübersicht.

Das folgende Codebeispiel zeigt, wie der Titel für ein PropertyGridEditorPart Steuerelement deklarativ auf einer Webseite festgelegt wird.

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

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

Im nächsten Teil des Codebeispiels wird gezeigt, wie der Wert der Title Eigenschaft programmgesteuert festgelegt wird. Um den programmgesteuert zugewiesenen Wert beizubehalten, wird eine statische Variable mit dem Namen editControlTitle verwendet, und dieser Wert wird der Title Eigenschaft bei jeder Initialisierung des Steuerelements zugewiesen, sodass der Wert zwischen Postbackereignissen beibehalten wird.

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

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

Wenn Sie die Seite in einem Browser laden, können Sie bearbeitungsmodus im Dropdownlistensteuerelement Anzeigemodus auswählen, um in den Bearbeitungsmodus zu wechseln. Sie können auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste des WebPart-Steuerelements Benutzerinformationen klicken und dann auf Bearbeiten klicken, um mit der Bearbeitung zu beginnen. Wenn die Bearbeitungs-Benutzeroberfläche (UI) sichtbar ist, können Sie das PropertyGridEditorPart Steuerelement sowie eine Schaltfläche und ein Textfeld darüber sehen. Beachten Sie, dass der Titel des Steuerelements PropertyGridEditorPart der Wert ist, der ihm im deklarativen Markup der Webseite zugewiesen ist. Wenn Sie text in das Textfeld neben der Schaltfläche Editor aktualisierenTeiltitel eingeben und dann auf die Schaltfläche klicken, wird der Titel des Steuerelements aktualisiert.

Hinweise

Der Title Eigenschaftswert wird in der Titelleiste eines PropertyGridEditorPart Steuerelements angezeigt, wenn das Steuerelement im Bearbeitungsmodus sichtbar ist. Wenn das Steuerelement auf einer Seite deklariert wird, können Sie einen Wert für das Title Attribut festlegen. Wenn Sie keinen Wert für den Titel angeben, wird ein kulturspezifischer Standardwert angegeben.

Die Title -Eigenschaft überschreibt die Basiseigenschaft, sodass, wenn kein Titelwert angegeben wird, ein Standardtitel, der einem PropertyGridEditorPart Steuerelement entspricht, vom Webparts-Steuerelementsatz bereitgestellt werden kann.

Weitere Informationen

• Title
• ASP.NET Webpart-Steuerelemente