CatalogZoneBase.InstructionText-Eigenschaft
Aktualisiert: November 2007
Ruft den Text in einer Zone ab, der Endbenutzern Anweisungen bereitstellt, oder legt diesen fest.
Assembly: System.Web (in System.Web.dll)
/** @property */ public String get_InstructionText() /** @property */ public void set_InstructionText(String value)
public override function get InstructionText () : String public override function set InstructionText (value : String)
<asp:CatalogZoneBase InstructionText="String" />
Eigenschaftenwert
Typ: System.StringEine Zeichenfolge, die die Anweisungen für Endbenutzer enthält. Eine vom Webparts-Steuerelementsatz bereitgestellte kulturspezifische Standardzeichenfolge.
Der Zeichenfolgenwert der InstructionText-Eigenschaft wird unmittelbar unter dem Headerbereich einer CatalogZoneBase-Zone angezeigt. Der Text der InstructionText-Eigenschaft wird angezeigt, wenn eine Seite in den Katalogmodus geschaltet wird und die Benutzeroberfläche des Katalogs sichtbar wird.
Die InstructionText-Eigenschaft stellt Benutzern allgemeine Anweisungen zu Aktionen auf der Benutzeroberfläche des Katalogs bereit.
Im folgenden Codebeispiel werden die deklarative und die programmgesteuerte Verwendung der InstructionText-Eigenschaft veranschaulicht. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Beispielabschnitt der Übersicht über die CatalogZoneBase-Klasse.
Im Codebeispiel werden zwei <asp:catalogzone>-Elemente deklariert. Das erste von ihnen deklariert einen Wert für die InstructionText-Eigenschaft.
<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 InstructionText-Eigenschaft in der ersten Zone programmgesteuert ein anderer Wert zugewiesen.
Beim Laden der Seite in einem Browser können Sie in der Dropdownliste die Option Katalog auswählen, um in den Kataloganzeigemodus zu wechseln. Sobald der Katalog sichtbar wird, können Sie feststellen, dass im Headerbereich jeder Zone der Wert der jeweiligen InstructionText-Eigenschaft angezeigt wird. Wenn Sie auf die Schaltfläche Texteigenschaften für Zone festlegen klicken, wird die InstructionText-Eigenschaft der oberen Zone auf den ihr im Code zugewiesenen Wert festgelegt.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
