CatalogZoneBase.SelectTargetZoneText Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft den Text neben dem Steuerelement auf der Benutzeroberfläche des Katalogs ab, das Benutzern die Auswahl der Zone ermöglicht, der die ausgewählten Steuerelemente hinzugefügt werden sollen.

public:
 virtual property System::String ^ SelectTargetZoneText { System::String ^ get(); void set(System::String ^ value); };
public virtual string SelectTargetZoneText { get; set; }
member this.SelectTargetZoneText : string with get, set
Public Overridable Property SelectTargetZoneText As String

Eigenschaftswert

String

Eine Zeichenfolge, die den neben dem Zonenauswahl-Steuerelement anzuzeigenden Text enthält. Eine kulturspezifische Standardzeichenfolge wird von .NET Framework bereitgestellt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SelectTargetZoneText Eigenschaft deklarativ und programmgesteuert verwendet wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der CatalogZoneBase Klassenübersicht.

Beachten Sie, dass der erste Teil des Codebeispiels zwei <asp:catalogzone> Elemente deklariert, und das erste Element einen Wert für die SelectTargetZoneText -Eigenschaft deklariert.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

Im zweiten Teil des Codebeispiels wird der Wert der SelectTargetZoneText Eigenschaft programmgesteuert geändert.

protected void Button3_Click(object sender, EventArgs e)
{
  CatalogZone1.SelectTargetZoneText = "Add to zone";
  CatalogZone1.EmptyZoneText = "Zone is empty";
  CatalogZone1.HeaderText = "My Updated Header";
  CatalogZone1.InstructionText = "My Updated Instructions";
}

Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  CatalogZone1.SelectTargetZoneText = "Add to zone"
  CatalogZone1.EmptyZoneText = "Zone is empty"
  CatalogZone1.HeaderText = "My Updated Header"
  CatalogZone1.InstructionText = "My Updated Instructions"
End Sub

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Katalog auswählen, um zum Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, notieren Sie sich den Text, der neben dem DropDownList Steuerelement in der Fußzeile des Katalogs angezeigt wird. Sie können auf die Schaltfläche Zonentexteigenschaften festlegen klicken, um den Textwert der Eigenschaft zu ändern.

Hinweise

Wenn die Katalog-Benutzeroberfläche zum ersten Mal angezeigt wird, können Benutzer eines der CatalogPart Steuerelemente auswählen, z DeclarativeCatalogPart. B. , das oder andere Serversteuerelemente enthält WebPart , die der Webseite hinzugefügt werden können. Der Benutzer wählt ein oder mehrere Steuerelemente aus und kann das DropDownList Steuerelement dann im Fußzeilenbereich des Katalogs verwenden und das Steuerelement auf der WebPartZone Seite auswählen, auf der die ausgewählten Serversteuerelemente platziert werden sollen. Der Textwert der SelectTargetZoneText -Eigenschaft wird neben dem DropDownList Steuerelement als einfache Anweisung angezeigt.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Gilt für:

Weitere Informationen