PropertyGridEditorPart.Title Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá nebo nastaví název ovládacího prvku editoru.

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

Hodnota vlastnosti

String

Řetězec, který se používá jako název ovládacího prvku. Výchozí hodnota je název počítaný ovládací prvek zadaný sadou ovládacích prvků webové části.

Příklady

Tento příklad kódu ukazuje, jak použít Title vlastnost PropertyGridEditorPart ovládacího prvku. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad tématu s přehledem PropertyGridEditorPart třídy.

Následující příklad kódu ukazuje, jak nastavit název PropertyGridEditorPart ovládacího prvku deklarativně na webové stránce.

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

Další část příkladu kódu ukazuje, jak nastavit hodnotu Title vlastnosti programově. Aby bylo možné zachovat programově přiřazenou hodnotu, použije se statická proměnná s názvem editControlTitle a tato hodnota se přiřadí vlastnosti Title při každé inicializaci ovládacího prvku, aby se hodnota zachovala mezi událostmi postback.

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

Když stránku načtete v prohlížeči, můžete výběrem možnosti Režim úprav v ovládacím prvku rozevíracího seznamu Režim zobrazení přepnout do režimu úprav. Můžete kliknout na nabídku sloves (šipka dolů) v záhlaví ovládacího prvku Webové části Informace o uživateli a kliknutím na Upravit zahájit úpravy. Když je uživatelské rozhraní pro úpravy viditelné, uvidíte PropertyGridEditorPart ovládací prvek a tlačítko a textové pole umístěné nad ním. Všimněte si, že název PropertyGridEditorPart ovládacího prvku je hodnota přiřazená v deklarativním kódu webové stránky. Pokud zadáte nějaký text do textového pole vedle tlačítka Aktualizovat editorNá titulek části a potom kliknete na toto tlačítko, název ovládacího prvku se aktualizuje.

Poznámky

Hodnota Title vlastnosti se zobrazí v záhlaví PropertyGridEditorPart ovládacího prvku, když je ovládací prvek viditelný v režimu úprav. Když je ovládací prvek deklarován na stránce, můžete nastavit hodnotu atributu Title . Pokud nezadáte hodnotu pro název, zadá se výchozí hodnota specifická pro jazykovou verzi.

Vlastnost Title přepíše základní vlastnost, takže pokud není zadána žádná hodnota názvu, lze pomocí sady webových částí zadat výchozí název odpovídající PropertyGridEditorPart ovládacímu prvku.

Viz také

• Title
• ASP.NET ovládací prvky webových částí