Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

CatalogZone-Klasse

 

Veröffentlicht: Oktober 2016

Dient als primäres Steuerelement im Webparts-Steuerelementsatz zum Hosten von CatalogPart-Steuerelementen auf einer Webseite.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.CompositeControl
        System.Web.UI.WebControls.WebParts.WebZone
          System.Web.UI.WebControls.WebParts.ToolZone
            System.Web.UI.WebControls.WebParts.CatalogZoneBase
              System.Web.UI.WebControls.WebParts.CatalogZone

public class CatalogZone : CatalogZoneBase

NameBeschreibung
System_CAPS_pubmethodCatalogZone()

Initialisiert eine neue Instanz der CatalogZone-Klasse.

NameBeschreibung
System_CAPS_pubpropertyAccessKey

Ruft ab oder legt die Zugriffstaste, die Sie schnell auf das Webserver-Steuerelement navigieren kann.(Geerbt von „WebControl“.)

System_CAPS_protpropertyAdapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.(Geerbt von „Control“.)

System_CAPS_pubpropertyAddVerb

Ruft einen Verweis auf ein WebPartVerb -Objekt, das Endbenutzer eine Webparts-Seite Steuerelemente aus einem Katalog hinzufügen kann.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Ruft ab oder legt das virtuelle Verzeichnis der Anwendung relativen des der Page oder UserControl -Objekt, das dieses Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyAssociatedDisplayModes

Ruft die Auflistung der WebPartDisplayMode verknüpften Objekte mit einem bestimmten ToolZone Zone.(Geerbt von „ToolZone“.)

System_CAPS_pubpropertyAttributes

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung), die keine entsprechenden Eigenschaften des Steuerelements.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyBackColor

Ruft ab oder legt die Farbe des Hintergrunds für das Webserver-Steuerelement.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyBackImageUrl

Ruft ab oder legt die URL zu einem Hintergrundbild für eine Zone fest.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyBindingContainer

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Steuerelement, das diesem Steuerelement Datenbindung enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyBorderColor

Ruft ab oder legt die Rahmenfarbe des Websteuerelements.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyBorderStyle

Ruft ab oder legt die Rahmenart für das Webserver-Steuerelement.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyBorderWidth

Ruft ab oder legt die Rahmenbreite des Webserversteuerelements.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyCatalogPartChrome

Ruft einen Verweis auf die Instanz von der CatalogPartChrome zugeordnete Klasse der CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyCatalogParts

Ruft eine Auflistung aller der CatalogPart Steuerelemente in einer CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protpropertyChildControlsCreated

Ruft einen Wert, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.(Geerbt von „Control“.)

System_CAPS_pubpropertyClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.(Geerbt von „Control“.)

System_CAPS_pubpropertyClientIDMode

Ruft ab oder legt den Algorithmus, der zum Generieren des Werts verwendet wird die ClientID Eigenschaft.(Geerbt von „Control“.)

System_CAPS_protpropertyClientIDSeparator

Ruft einen Zeichenwert, der verwendete Trennzeichen darstellt ab der ClientID Eigenschaft.(Geerbt von „Control“.)

System_CAPS_pubpropertyCloseVerb

Ruft einen Verweis auf ein WebPartVerb -Objekt, das Endbenutzer können die Katalog-Benutzeroberfläche (UI) schließen und die Seite wieder in den normalen Durchsuchen-Modus.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protpropertyContext

Ruft die HttpContext Objekt, das mit dem Steuerelement für die aktuelle Webanfrage zugeordnet.(Geerbt von „Control“.)

System_CAPS_pubpropertyControls

Ruft ein ControlCollection -Objekt, das die untergeordneten Steuerelemente in einem CompositeControl.(Geerbt von „CompositeControl“.)

System_CAPS_pubpropertyControlStyle

Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyControlStyleCreated

Ruft einen Wert, der angibt, ob ein Style Objekt wurde für die ControlStyle Eigenschaft. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyCssClass

Ruft ab oder legt die Cascading Stylesheet (CSS)-Klasse, die durch das Webserver-Steuerelement auf dem Client gerendert.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyDataItemContainer

Ruft einen Verweis auf den Benennungscontainer, wenn der Benennungscontainer implementiert IDataItemContainer.(Geerbt von „Control“.)

System_CAPS_pubpropertyDataKeysContainer

Ruft einen Verweis auf den Benennungscontainer, wenn der Benennungscontainer implementiert IDataKeysControl.(Geerbt von „Control“.)

System_CAPS_protpropertyDesignMode

Ruft einen Wert, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.(Geerbt von „Control“.)

System_CAPS_protpropertyDisplay

Ruft einen Wert, der angibt, ob ein ToolZone -Steuerelements angezeigt wird.(Geerbt von „ToolZone“.)

System_CAPS_pubpropertyEditUIStyle

Ruft die Stilattribute für die bearbeitbaren Steuerelemente einem ToolZone Steuerelement.(Geerbt von „ToolZone“.)

System_CAPS_pubpropertyEmptyZoneText

Dient zum Abrufen oder Festlegen einer Meldung, die angezeigt wird, wenn eine Zone keine Steuerelemente enthält.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyEmptyZoneTextStyle

Ruft die Stilattribute für den Platzhaltertext in einer leeren Zone ab.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyEnabled

Ruft ab oder legt einen Wert, der angibt, ob das Webserver-Steuerelement aktiviert ist.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyEnableTheming

Ruft ab oder legt einen Wert, der angibt, ob für dieses Steuerelement Designs gelten.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyEnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.(Geerbt von „Control“.)

System_CAPS_pubpropertyErrorStyle

Ruft die Stilattribute für der Fehlermeldung zu rendern, wenn angezeigt wird ein WebPart Steuerelement kann nicht geladen oder erstellt werden.(Geerbt von „WebZone“.)

System_CAPS_protpropertyEvents

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.(Geerbt von „Control“.)

System_CAPS_pubpropertyFont

Ruft das Webserver-Steuerelement zugeordneten Eigenschaften für die Schriftart ab.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyFooterStyle

Ruft die Stilattribute für den Inhalt der Fußzeile einer Zone.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyForeColor

Ruft ab oder legt die Vordergrundfarbe (i. d. r. die Textfarbe) des Webserversteuerelements.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyHasAttributes

Ruft einen Wert, der angibt, ob das Steuerelement Attribute festgelegt wurden.(Geerbt von „WebControl“.)

System_CAPS_protpropertyHasChildViewState

Ruft einen Wert, der angibt, ob die untergeordneten Steuerelemente des aktuellen Steuerelements gespeicherten Ansichtszustand Einstellungen verfügen.(Geerbt von „Control“.)

System_CAPS_protpropertyHasFooter

Ruft einen Wert, der angibt, ob eine Zone einen Footerbereich besitzt.(Geerbt von „WebZone“.)

System_CAPS_protpropertyHasHeader

Ruft einen Wert, der angibt, ob eine Zone einen Headerbereich besitzt.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyHeaderCloseVerb

Ruft einen Verweis auf die WebPartVerb Objekt im Header des ein ToolZone Steuerelement, das verwendet wird, um das Steuerelement zu schließen.(Geerbt von „ToolZone“.)

System_CAPS_pubpropertyHeaderStyle

Ruft die Stilattribute für den Inhalt des Headerbereichs einer Zone.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyHeaderText

Ruft den Text für den Headerbereich einer Zone ab oder legt ihn fest.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyHeaderVerbStyle

Ruft die Stilattribute für alle Headerverben angezeigt, die einem ToolZone Steuerelement.(Geerbt von „ToolZone“.)

System_CAPS_pubpropertyHeight

Ruft ab oder legt die Höhe des Webserversteuerelements.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyID

Ruft ab oder legt den programmgesteuerten Bezeichner für das Webserversteuerelement zugewiesen.(Geerbt von „Control“.)

System_CAPS_protpropertyIdSeparator

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Zeichen zum Trennen der Steuerelement-IDs verwendet.(Geerbt von „Control“.)

System_CAPS_pubpropertyInstructionText

Ruft ab oder legt den Text in einer Zone, die Anweisungen für Endbenutzer bietet.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyInstructionTextStyle

Ruft die Stilattribute für den Anweisungstext, die am oberen Rand wird ein ToolZone Steuerelement.(Geerbt von „ToolZone“.)

System_CAPS_protpropertyIsChildControlStateCleared

Ruft einen Wert, der angibt, ob dieses Steuerelement enthaltenen Steuerelemente Steuerelementzustand verfügen.(Geerbt von „Control“.)

System_CAPS_protpropertyIsEnabled

Ruft einen Wert, der angibt, ob das Steuerelement aktiviert ist.(Geerbt von „WebControl“.)

System_CAPS_protpropertyIsTrackingViewState

Ruft einen Wert, der angibt, ob das Serversteuerelement Änderungen an seinem Ansichtszustand gespeichert wird.(Geerbt von „Control“.)

System_CAPS_protpropertyIsViewStateEnabled

Ruft einen Wert, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.(Geerbt von „Control“.)

System_CAPS_pubpropertyLabelStyle

Ruft die Stilattribute für den Inhalt der Bezeichnungen, die zusammen mit der Bearbeitung von Steuerelementen in einem ToolZone Steuerelement. Die abgeleitete ToolZone Steuerelemente, z. B. CatalogZone und EditorZone, die Formatvorlagen der Bezeichnungen.(Geerbt von „ToolZone“.)

System_CAPS_protpropertyLoadViewStateByID

Ruft einen Wert, der angibt, ob das Steuerelement seinen Ansichtszustand über laden ID anstelle Index.(Geerbt von „Control“.)

System_CAPS_pubpropertyNamingContainer

Ruft ein Verweis auf das Serversteuerelement Benennungscontainers, erstellt einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben Control.ID Eigenschaftswert.(Geerbt von „Control“.)

System_CAPS_pubpropertyPadding

Ruft ab oder legt die Zelle Abstand Attribute auf die Tabelle mit den WebPart -Steuerelemente in einer Zone.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyPage

Ruft einen Verweis auf die Page -Instanz, die das Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyParent

Ruft einen Verweis auf die übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.(Geerbt von „Control“.)

System_CAPS_pubpropertyPartChromePadding

Ruft ab oder legt den Abstand zwischen dem Inhalt einer WebPart -Steuerelement und dem Rahmen des Steuerelements.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyPartChromeStyle

Ruft die Stileigenschaften, die für den Rahmen einer Zone enthaltenen Webparts-Steuerelemente gelten.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyPartChromeType

Ruft ab oder legt den Typ des Rahmens, der enthaltenen Frames Webparts-Steuerelemente einer Zone.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyPartLinkStyle

Ruft ein Objekt, das Stilattribute für enthält die CatalogPart Steuerelemente, die in der Zone derzeit nicht ausgewählt sind.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyPartStyle

Ruft die Stileigenschaften, die für den Rahmen und Inhalt der einer Zone enthaltenen Webparts-Steuerelemente gelten.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyPartTitleStyle

Ruft die Stilattribute für die Title-Onlineinhalte für jedes einer Zone enthaltenen Webparts-Steuerelement ab.(Geerbt von „WebZone“.)

System_CAPS_protpropertyRenderClientScript

Ruft einen Wert, der angibt, ob das Clientskript auf einer Webparts-Seite gerendert.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyRenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der das gerenderte HTML kompatibel ist. (Geerbt von „Control“.)

System_CAPS_pubpropertySelectedCatalogPartID

Ruft ab oder legt eine Zeichenfolge als Bezeichner für das derzeit ausgewählte CatalogPart in einer Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertySelectedPartLinkStyle

Ruft ein Objekt, das Stilattribute für enthält die CatalogPart -Steuerelement, das in der Zone derzeit ausgewählt ist.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertySelectTargetZoneText

Ruft ab oder legt den Text neben dem Steuerelement in der Katalog-Benutzeroberfläche (UI), die Benutzern ermöglicht, wählen Sie die Zone, die die ausgewählten Steuerelemente hinzufügen.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertyShowCatalogIcons

Ruft ab oder legt einen Wert, der angibt, ob Serversteuerelemente im Katalog die zugehörigen Symbole im Katalog angezeigt werden.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubpropertySite

Ruft Informationen über den Container, der das aktuelle Steuerelement beim Rendern auf einer Entwurfsoberfläche hostet.(Geerbt von „Control“.)

System_CAPS_pubpropertySkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyStyle

Ruft eine Auflistung von Textattributen, die als ein Formatattribut am äußeren Tag des Webserversteuerelements gerendert werden.(Geerbt von „WebControl“.)

System_CAPS_pubpropertySupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.(Geerbt von „CompositeControl“.)

System_CAPS_pubpropertyTabIndex

Ruft ab oder legt die Aktivierreihenfolge des Webserversteuerelements.(Geerbt von „WebControl“.)

System_CAPS_protpropertyTagKey

Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebZone“.)

System_CAPS_protpropertyTagName

Ruft den Namen des Steuerelementtags. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyTemplateControl

Ruft ab oder legt einen Verweis auf die Vorlage, die dieses Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyTemplateSourceDirectory

Ruft das virtuelle Verzeichnis von der Page oder UserControl die das aktuelle Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyToolTip

Ruft ab oder legt den Text angezeigt, wenn der Mauszeiger über das Webserver-Steuerelement bewegt wird.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyUniqueID

Ruft den eindeutigen, hierarchisch qualifizierten Bezeichner für das Steuerelement ab.(Geerbt von „Control“.)

System_CAPS_pubpropertyValidateRequestMode

Ruft ab oder legt einen Wert, der angibt, ob der Clienteingaben vom Browser auf potenziell gefährliche Werte überprüft.(Geerbt von „Control“.)

System_CAPS_pubpropertyVerbButtonType

Ruft ab oder legt fest, welche Art von Schaltfläche zum Darstellen von Verben in einer Zone verwendet wird.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyVerbStyle

Ruft die Stilattribute für die Webparts-Steuerelemente in einer Zone zugeordneten Benutzer-Benutzeroberfläche (UI)-Verben ab.(Geerbt von „WebZone“.)

System_CAPS_protpropertyViewState

Ruft ein Wörterbuch von Statusinformationen, die zum Speichern und Wiederherstellen den Ansichtszustand eines Serversteuerelements in mehreren Anforderungen der gleichen Seite ermöglicht.(Geerbt von „Control“.)

System_CAPS_protpropertyViewStateIgnoresCase

Ruft einen Wert, der angibt, ob die StateBag Objekt wird Groß-/Kleinschreibung.(Geerbt von „Control“.)

System_CAPS_pubpropertyViewStateMode

Ruft ab oder legt den Modus Ansichtszustand des Steuerelements fest.(Geerbt von „Control“.)

System_CAPS_pubpropertyVisible

Ruft ab oder legt einen Wert, der angibt, ob ein Serversteuerelement als ein Benutzeroberflächenelement (UI) auf der Seite gerendert wird.(Geerbt von „ToolZone“.)

System_CAPS_protpropertyWebPartManager

Ruft einen Verweis auf die WebPartManager zugeordneten Steuerelements eine WebZone Steuerelementinstanz auf einer Webparts-Seite.(Geerbt von „WebZone“.)

System_CAPS_pubpropertyWidth

Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest.(Geerbt von „WebControl“.)

System_CAPS_pubpropertyZoneTemplate

Ruft ab oder legt eine Vorlage für den untergeordneten Steuerelementen in einem CatalogZone Steuerelement in einem persistenten Format.

NameBeschreibung
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

Fügt HTML-Attribute und-Stile gerendert werden in den angegebenen HtmlTextWriterTag. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_protmethodAddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement hinzugefügt wird die Controls Auflistung von der Control Objekt.(Geerbt von „Control“.)

System_CAPS_protmethodAddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.(Geerbt von „Control“.)

System_CAPS_pubmethodApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage auf das Steuerelement, überschreiben Stilelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Wendet die Stileigenschaften, die im Stylesheet Seite auf das Steuerelement definiert.(Geerbt von „Control“.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Beginnt die Entwurfszeit-Verfolgung des Renderings von Daten.(Geerbt von „Control“.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Sammelt Informationen über das Steuerelement und übermittelt sie an die Trace -Eigenschaft angezeigt, wenn die Überwachung für die Seite aktiviert ist.(Geerbt von „Control“.)

System_CAPS_protmethodClearCachedClientID()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Legt die zwischengespeicherte ClientID Wert null.(Geerbt von „Control“.)

System_CAPS_protmethodClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.(Geerbt von „Control“.)

System_CAPS_protmethodClearChildState()

Löscht den Ansichtszustand und den Steuerelementzustand Informationen für alle des Serversteuerelements untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodClearChildViewState()

Löscht die Informationen zum Ansichtszustand für alle Serversteuerelemente untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Legt die ClientIDMode -Eigenschaft der aktuellen Steuerelementinstanz und alle untergeordneten Steuerelemente entsprechend Inherit.(Geerbt von „Control“.)

System_CAPS_protmethodClose()

Schaltet die Webseite von Kataloganzeigemodus in den normalen Durchsuchen-Modus.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

Kopiert die Eigenschaften, die nicht vom gekapselt sind die Style Objekt aus dem angegebenen Webserver-Steuerelement, das Webserver-Steuerelement, das diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_protmethodCreateCatalogPartChrome()

Erstellt eine Instanz einer CatalogPartChrome zum Rendern von Peripheriegeräten Benutzers Elemente der Benutzeroberfläche (UI) für Objekt CatalogPart -Steuerelemente in einer Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodCreateCatalogParts()

Erstellt eine Instanz der einzelnen CatalogPart Typ, der in der Zone deklariert ist.(Überschreibt CatalogZoneBase.CreateCatalogParts().)

System_CAPS_protmethodCreateChildControls()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Erstellt den Satz der untergeordneten Steuerelemente zugeordnet eine CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodCreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.(Geerbt von „Control“.)

System_CAPS_protmethodCreateControlStyle()

Erstellt das Formatvorlagenobjekt, das intern von verwendet wird, wird die WebControl -Klasse zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_pubmethodDataBind()

Bindet eine Datenquelle an das CompositeControl und alle untergeordneten Steuerelemente.(Geerbt von „CompositeControl“.)

System_CAPS_protmethodDataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option zum Auslösen der DataBinding Ereignis.(Geerbt von „Control“.)

System_CAPS_protmethodDataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.(Geerbt von „Control“.)

System_CAPS_pubmethodDispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor sie aus dem Speicher freigegeben wird.(Geerbt von „Control“.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Zur Entwurfszeit die Verfolgung von Renderingdaten wird beendet.(Geerbt von „Control“.)

System_CAPS_protmethodEnsureChildControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, erstellt er auf die untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodEnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.(Geerbt von „Control“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFindControl(String)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id Parameter.(Geerbt von „Control“.)

System_CAPS_protmethodFindControl(String, Int32)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und eine ganze Zahl, die gemäß der pathOffset -Parameter, der die Suche unterstützt. Sie sollten diese Version von nicht überschreiben die FindControl Methode.(Geerbt von „Control“.)

System_CAPS_pubmethodFocus()

Legt den Eingabefokus auf ein Steuerelement.(Geerbt von „Control“.)

System_CAPS_protmethodGetDesignModeState()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft die Entwurfszeitdaten für ein Steuerelement ab.(Geerbt von „Control“.)

System_CAPS_pubmethodGetEffectiveChromeType(Part)

Gibt den tatsächlichen bzw. den effektiven aktuellen PartChromeType Wert einer WebPart -Steuerelements entsprechend der PartChromeType Eigenschaft der Zone und dem aktuellen Anzeigemodus der Webparts-Seite.(Geerbt von „WebZone“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetRouteUrl(Object)

Ruft die URL, die einen Satz von Routenparametern entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Ruft die URL, die einen Satz von Routenparametern entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Ruft die URL, die einen Satz von Routenparametern und einem Routennamen entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Ruft die URL, die einen Satz von Routenparametern und einem Routennamen entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Gibt den Präfixen Teil der UniqueID -Eigenschaft des angegebenen Steuerelements.(Geerbt von „Control“.)

System_CAPS_pubmethodHasControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.(Geerbt von „Control“.)

System_CAPS_protmethodHasEvents()

Gibt einen Wert, der angibt, ob Ereignisse für das Steuerelement oder einem beliebigen untergeordneten Steuerelement registriert werden.(Geerbt von „Control“.)

System_CAPS_protmethodInvalidateCatalogParts()

Löscht die Auflistung der CatalogPart zugeordneten Steuerelemente eine CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodIsLiteralContent()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Bestimmt, ob das Serversteuerelement nur literalen Inhalt enthält.(Geerbt von „Control“.)

System_CAPS_protmethodLoadControlState(Object)

Lädt den Zustand von einer vorherigen Seitenanforderung Eigenschaften für Steuerelemente, die über mehrere Postbacks hinweg aufrechterhalten werden soll, selbst wenn der Ansichtszustand für das Steuerelement deaktiviert ist.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodLoadPostData(String, NameValueCollection)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Verarbeitet den Zustand von Kontrollkästchen, die die entsprechen den WebPart -Steuerelemente im Katalog, wenn die Seite zurück an den Server zurückgesendet wird.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodLoadViewState(Object)

Lädt zuvor gespeicherte Zustandsinformationen für eine Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodMapPathSecure(String)

Ruft den physischen Pfad, dem ein virtueller Pfad, einen absoluten oder relativen zugeordnet ist.(Geerbt von „Control“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodMergeStyle(Style)

Kopiert, die alle nicht leeren Elemente der angegebenen Formatvorlage im Web zu steuern, die aber überschreibt keine vorhandenen Stilelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.(Geerbt von „Control“.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Stellt eine Basismethode-Deklaration, die abgeleitete ToolZone Steuerelemente können außer Kraft setzen, um die Details der Änderung des Anzeigemodus für eine spezielle Zone zu behandeln.(Geerbt von „ToolZone“.)

System_CAPS_protmethodOnInit(EventArgs)

Registriert das Seitenobjekt, damit die Seite Steuerelementzustand erforderlich ist.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodOnLoad(EventArgs)

Löst das Load-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOnPreRender(EventArgs)

Löst das PreRender -Ereignis aus und registriert die Seite Objekt, sodass es Postbacks erforderlich sind.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodOnSelectedWebPartChanged(Object, WebPartEventArgs)

Stellt eine Basismethode-Deklaration, die abgeleitete ToolZone Steuerelemente zum Behandeln des Ereignisses ändern, welche Webparts-Steuerelement ausgewählt ist, innerhalb einer speziellen Zone überschreiben können.(Geerbt von „ToolZone“.)

System_CAPS_protmethodOnUnload(EventArgs)

Löst das Unload-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOpenFile(String)

Ruft eine Stream verwendet, um eine Datei zu lesen.(Geerbt von „Control“.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Weist eine beliebige Quelle des Ereignisses und den zugehörigen übergeordneten Element des Steuerelements.(Geerbt von „Control“.)

System_CAPS_protmethodRaisePostBackEvent(String)

Führt die Aktionen in Verbindung mit einem der Zone Verben oder löst ein Ereignis aus, die an den Server zurückgesendet.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodRecreateChildControls()

Erstellt die untergeordneten Steuerelemente in einem Steuerelement abgeleitet CompositeControl.(Geerbt von „CompositeControl“.)

System_CAPS_protmethodRemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus entfernt, wird die Controls Auflistung von der Control Objekt.(Geerbt von „Control“.)

System_CAPS_protmethodRender(HtmlTextWriter)

Rendert die Zone mit dem angegebenen HtmlTextWriter Objekt.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Rendert das öffnende HTML-Tag des Zonensteuerelements im angegebenen HtmlTextWriter Objekt.(Geerbt von „WebZone“.)

System_CAPS_protmethodRenderBody(HtmlTextWriter)

Überschreibt die Basismethode, um den Inhaltsbereich einer Zone, die von abgeleiteten Rendern der CatalogZoneBase Klasse.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodRenderCatalogPartLinks(HtmlTextWriter)

Rendert die Links zu dem einzelnen CatalogPart von Steuerelementen in einem CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gibt den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter -Objekt, das den zu rendernden Inhalt auf dem Client schreibt.(Geerbt von „Control“.)

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Rendert den gesamten Inhalt eines Steuerelements Zone zwischen dem Anfangs- und Endtags mit dem angegebenen HtmlTextWriter Objekt.(Geerbt von „WebZone“.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter -Objekt und Ablaufverfolgungsinformationen über das Steuerelement speichert, wenn die Überwachung aktiviert ist.(Geerbt von „Control“.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter -Objekt mithilfe eines bereitgestellten ControlAdapter Objekt.(Geerbt von „Control“.)

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

Stellt das HTML-Endtag des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.(Geerbt von „WebControl“.)

System_CAPS_protmethodRenderFooter(HtmlTextWriter)

Rendert den Footerbereich für eine CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodRenderHeader(HtmlTextWriter)

Überschreibt die Basismethode, um spezielle Darstellung für den Headerbereich erforderlichen bereitzustellen ToolZone Steuerelemente.(Geerbt von „ToolZone“.)

System_CAPS_protmethodRenderVerb(HtmlTextWriter, WebPartVerb)

Rendert ein einzelnes Verb mit einem ToolZone Steuerelement.(Geerbt von „ToolZone“.)

System_CAPS_protmethodRenderVerbs(HtmlTextWriter)

Rendert die Verben im Footerbereich einer CatalogZoneBase Zone.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodResolveAdapter()

Ruft den Steuerelementadapter ab, für das Rendern des angegebenen Steuerelements verantwortlich.(Geerbt von „Control“.)

System_CAPS_pubmethodResolveClientUrl(String)

Ruft eine URL, die vom Browser verwendet werden kann.(Geerbt von „Control“.)

System_CAPS_pubmethodResolveUrl(String)

Konvertiert eine URL in eine, die auf dem anfordernden Client verwendet werden kann.(Geerbt von „Control“.)

System_CAPS_protmethodSaveControlState()

Speichert Änderungen in einem CatalogZoneBase Zustand des Steuerelements, die auftreten, nachdem die Webseite an den Server zurückgesendet wird.(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodSaveViewState()

Speichert alle Ansichtszustandsänderungen, die nach dem Zurücksenden einer Seite an den Server aufgetreten sind(Geerbt von „CatalogZoneBase“.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.(Geerbt von „Control“.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Weist einen Ereignishandlerdelegaten für das Steuerelement und dessen Inhalt im übergeordneten Steuerelement zu rendern.(Geerbt von „Control“.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Legt die Ablaufverfolgungsdaten für die Entwurfszeit-Verfolgung von Daten unter Verwendung der Trace-Datenschlüssel und den Trace-Wert.(Geerbt von „Control“.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Legt die Ablaufverfolgungsdaten für die Entwurfszeit-Verfolgung von Renderingdaten, indem Sie das verfolgte Objekt der Trace-Datenschlüssel und den Trace-Wert.(Geerbt von „Control“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_protmethodTrackViewState()

Verfolgt die am Ansichtszustand eines Zonensteuerelements vorgenommenen Änderungen.(Geerbt von „CatalogZoneBase“.)

NameBeschreibung
System_CAPS_pubeventDataBinding

Tritt auf, wenn das Steuerelement an eine Datenquelle bindet.(Geerbt von „Control“.)

System_CAPS_pubeventDisposed

Tritt auf, wenn ein Steuerelement aus dem Speicher freigegeben wird, die ist die letzte Phase des Lebenszyklus der ASP.NET-Seite angefordert wird.(Geerbt von „Control“.)

System_CAPS_pubeventInit

Tritt auf, wenn das Steuerelement initialisiert wird, ist der erste Schritt im Lebenszyklus.(Geerbt von „Control“.)

System_CAPS_pubeventLoad

Tritt auf, wenn das Steuerelement geladen wird die Page Objekt.(Geerbt von „Control“.)

System_CAPS_pubeventPreRender

Tritt ein, nachdem die Control Objekt ist geladen, jedoch vor dem Rendern.(Geerbt von „Control“.)

System_CAPS_pubeventUnload

Tritt auf, wenn das Steuerelement aus dem Speicher entladen wird.(Geerbt von „Control“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.(Geerbt von „WebControl“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Legt ein Attribut des Websteuerelements auf dem angegebenen Namen und Wert fest.(Geerbt von „WebControl“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.GetDesignModeState.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.SetDesignModeState.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.SetOwnerControl.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter IParserAccessor.AddParsedSubObject.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

Implementiert die IPostBackDataHandler.LoadPostData Methode durch Aufrufen der LoadPostData Methode der CatalogZoneBase Klasse.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

Eine Beschreibung dieses Elements finden Sie unter RaisePostDataChangedEvent.(Geerbt von „CatalogZoneBase“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackEventHandler.RaisePostBackEvent(String)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Implementiert die RaisePostBackEvent-Methode.(Geerbt von „ToolZone“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICompositeControlDesignerAccessor.RecreateChildControls()

Ermöglicht es dem Designer das zusammengesetzte Steuerelement Auflistung von untergeordneten Steuerelementen in der Entwurfsphase neu erstellen.(Geerbt von „CompositeControl“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter IControlBuilderAccessor.ControlBuilder.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.UserData.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter IDataBindingsAccessor.DataBindings.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter IDataBindingsAccessor.HasDataBindings.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter IExpressionsAccessor.Expressions.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter IExpressionsAccessor.HasExpressions.(Geerbt von „Control“.)

NameBeschreibung
System_CAPS_pubmethodEnableDynamicData(Type)

Überladen. Aktiviert das Dynamic Data-Verhalten für das angegebene Steuerelement.(Definiert durch DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, IDictionary<String, Object>)

Überladen. Aktiviert das Dynamic Data-Verhalten für das angegebene Steuerelement.(Definiert durch DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, Object)

Überladen. Aktiviert das Dynamic Data-Verhalten für das angegebene Steuerelement.(Definiert durch DataControlExtensions.)

System_CAPS_pubmethodFindDataSourceControl()

Gibt die Datenquelle, die das Steuerelement für das angegebene Steuerelement zugeordnet ist.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Gibt die Feldvorlage für die angegebene Spalte in das angegebene Steuerelement Benennungscontainer zurück.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Gibt das Metatabelle für das enthaltende Datensteuerelement zurück.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Überladen. Ruft die Auflistung der Standardwerte für das angegebene Steuerelement ab.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Überladen. Ruft die Tabellenmetadaten für das angegebene Steuerelement ab.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable)

Überladen. Legt die Tabellenmetadaten für das angegebene Steuerelement fest.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, IDictionary<String, Object>)

Überladen. Die Tabelle-Metadaten und Default-Wert-Zuordnung für das angegebene Steuerelement festgelegt.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, Object)

Überladen. Die Tabelle-Metadaten und Default-Wert-Zuordnung für das angegebene Steuerelement festgelegt.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Überladen. Bestimmt, ob Tabellenmetadaten verfügbar sind.(Definiert durch DynamicDataExtensions.)

Within the Web Parts control set, a zone is a region on a Web page that contains Web Parts controls. A Web Parts zone is created by a zone control, which is a type of T:System.Web.UI.WebControls.CompositeControl designed to contain other controls. The primary functions of a zone are to lay out the controls it contains, and to provide a common user interface (UI) for those controls. For general information about zones and how they are used in Web Parts applications, see the base T:System.Web.UI.WebControls.WebParts.WebZone class, and Web Parts Control Set Overview.

A key feature of Web Parts controls is that they allow end users to modify (or personalize) Web pages according to their preferences, and save their personalized settings for future browser sessions. One aspect of modifying Web Parts pages includes the ability to add T:System.Web.UI.WebControls.WebParts.WebPart controls or other server controls to a Web Parts page. The T:System.Web.UI.WebControls.WebParts.CatalogZone control provides a list or catalog of controls that users can add to a page.

The T:System.Web.UI.WebControls.WebParts.CatalogZone control is one of the fundamental controls in the Web Parts control set. It derives from the T:System.Web.UI.WebControls.WebParts.CatalogZoneBase class, and most of its behavior is inherited from that class. The T:System.Web.UI.WebControls.WebParts.CatalogZone class essentially adds to the base class a zone template, which is an implementation of the T:System.Web.UI.ITemplate interface. The zone template enables developers to declaratively add T:System.Web.UI.WebControls.WebParts.CatalogPart controls to a zone in the page persistence format.

System_CAPS_importantWichtig

A T:System.Web.UI.WebControls.WebParts.CatalogZone zone can contain only T:System.Web.UI.WebControls.WebParts.CatalogPart controls, and conversely, T:System.Web.UI.WebControls.WebParts.CatalogPart controls can reside only in zones that derive from the T:System.Web.UI.WebControls.WebParts.CatalogZoneBase class, such as T:System.Web.UI.WebControls.WebParts.CatalogZone.

A T:System.Web.UI.WebControls.WebParts.CatalogZone control becomes visible only when a user switches a Web page to catalog display mode (F:System.Web.UI.WebControls.WebParts.WebPartManager.CatalogDisplayMode). A catalog can contain several types of T:System.Web.UI.WebControls.WebParts.CatalogPart controls. Each T:System.Web.UI.WebControls.WebParts.CatalogPart control is a type of container that contains the server controls users can add to the page. The T:System.Web.UI.WebControls.WebParts.CatalogPart controls differ according to where the server controls they contain are coming from. The following table summarizes the T:System.Web.UI.WebControls.WebParts.CatalogPart controls provided with the Web Parts control set and, for each control, what kind of server controls it contains.

Control

Description

PageCatalogPart

Maintains references to controls that have been closed on a page. These controls can be reopened (added back to the page) by users.

DeclarativeCatalogPart

Contains references to controls that are declared in a Web Parts catalog in the markup of a Web page. These controls can be added to a Web page by users.

ImportCatalogPart

Provides the UI for a user to upload a definition file (an XML file with a .WebPart extension and a specified format that contains state information) for a control to a catalog, so that the control can be added to a Web page.

Because the T:System.Web.UI.WebControls.WebParts.CatalogZone class adds only a zone template to the behavior of its base class, it has few members. The M:System.Web.UI.WebControls.WebParts.CatalogZone.#ctor constructor is a default constructor; with it, you can initialize a new instance of the T:System.Web.UI.WebControls.WebParts.CatalogZone class. The P:System.Web.UI.WebControls.WebParts.CatalogZone.ZoneTemplate property gets or sets a reference to the T:System.Web.UI.ITemplate object that contains the controls for the zone. The M:System.Web.UI.WebControls.WebParts.CatalogZone.CreateCatalogParts method is critical. It overrides the base method to create the collection of all T:System.Web.UI.WebControls.WebParts.CatalogPart controls contained within the zone template.

System_CAPS_noteHinweis

The buttons in the T:System.Web.UI.WebControls.WebParts.CatalogZone UI require client-side scripting in order to work correctly. If scripting is disabled in the browser, the user will not be able to perform actions through the T:System.Web.UI.WebControls.WebParts.CatalogZone UI.

The markup rendered by default for this control might not conform to accessibility standards such as the Web Content Accessibility Guidelines 1.0 (WCAG) priority 1 guidelines. For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

Hinweise für Vererber:

You can create custom T:System.Web.UI.WebControls.WebParts.CatalogZone classes if you want more control over the rendering and behavior of the catalog UI. If you do not need to provide users of your control with the ability to add T:System.Web.UI.WebControls.WebParts.CatalogPart controls declaratively, then you can inherit directly from the T:System.Web.UI.WebControls.WebParts.CatalogZoneBase class. If you do want to enable controls to be added declaratively, the simples approach is to inherit from the T:System.Web.UI.WebControls.WebParts.CatalogZone class, because it provides the essential zone template.

If you inherit from the T:System.Web.UI.WebControls.WebParts.CatalogZone class, you can override the M:System.Web.UI.WebControls.WebParts.CatalogZone.CreateCatalogParts method and use the method to add custom T:System.Web.UI.WebControls.WebParts.CatalogPart controls to a T:System.Web.UI.WebControls.WebParts.CatalogPartCollection, if you want greater programmatic control over adding custom T:System.Web.UI.WebControls.WebParts.CatalogPart controls to your zone.

The following code example demonstrates declarative and programmatic use of the T:System.Web.UI.WebControls.WebParts.CatalogZone control. The code example has four parts:

  • A user control that enables you to change display modes on the Web page.

  • A file with the source code for a custom T:System.Web.UI.WebControls.WebParts.CatalogZone control, and a custom T:System.Web.UI.WebControls.WebParts.WebPart control that is imported by the catalog and added to the Web page.

  • A Web page that declares the user control, and the custom T:System.Web.UI.WebControls.WebParts.CatalogZone control.

  • An explanation of how to run the example.

The first part of this code example is the user control that enables users to change display modes on a Web page. For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">

 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }

  }

  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

The second part of the code example contains the code for the custom T:System.Web.UI.WebControls.WebParts.CatalogZone and T:System.Web.UI.WebControls.WebParts.WebPart controls. The code for the T:System.Web.UI.WebControls.WebParts.CatalogZone control demonstrates how to inherit from the T:System.Web.UI.WebControls.WebParts.CatalogZone class and customize its properties by setting some default property values in the constructor. The source code also demonstrates how to create a custom T:System.Web.UI.WebControls.WebParts.WebPart class named TextDisplayWebPart. This is the control associated with the .WebPart description file that you will import as part of this code example. After you import the description file by using the T:System.Web.UI.WebControls.WebParts.ImportCatalogPart control on the Web page, you'll be able to add the TextDisplayWebPart control to the page, fully pre-configured as specified in the description file.

For the code example to run, you must compile this source code. You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. This code example uses dynamic compilation, so if you want to run the example this way, name the source code file and add it to an App_Code subfolder of your Web application's root directory. For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Server Control.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }


  // Create a custom WebPart control to add to a WebPartZone.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);

    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (input.Text != String.Empty)
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }

}

The third part of the code example is the Web page that contains the controls. It contains a Register directive for the user control, and another for the source file with the custom controls. Note that in the second directive, it does not name the assembly, because the example does not use an assembly, it uses dynamic compilation with the source code placed in the App_Code subfolder. The Web page declares a T:System.Web.UI.WebControls.WebParts.WebPartZone control, and within its child <zonetemplate> element, it declares a T:System.Web.UI.WebControls.BulletedList control. While this is a standard ASP.NET control, it will have full Web Parts functionality at run time, because the T:System.Web.UI.WebControls.WebParts.WebPartManager control wraps any server control placed in a T:System.Web.UI.WebControls.WebParts.WebPartZone with a T:System.Web.UI.WebControls.WebParts.GenericWebPart object, so that other server controls can participate in Web Parts applications. Also declared in this zone is the custom T:System.Web.UI.WebControls.WebParts.WebPart control named TextDisplayWebPart. Notice that this control has an attribute of ExportMode="All" declared on it. This enables you to export a .WebPart description file that contains the property values of the control, which can be imported by other users to add the pre-configured control to other Web pages.

System_CAPS_noteHinweis

To enable users of a Web Parts application to export a description file for T:System.Web.UI.WebControls.WebParts.WebPart controls, you must also enable the export feature in the Web application by adding an enableExport="true" attribute to the <webParts> element (which is a child of the <system.web> element) in the Web.config file. Export is disabled by default, so if you not yet enabled export for your application, edit the Web.config file and do it now.

The Web page also declares the custom T:System.Web.UI.WebControls.WebParts.CatalogZone control and, within it, a <zonetemplate> element that contains an T:System.Web.UI.WebControls.WebParts.ImportCatalogPart control. The user will use this control at run time to import the .WebPart description file for the custom T:System.Web.UI.WebControls.WebParts.WebPart control.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

Now run the code example. Load the Web page in a browser. The first step is to export a .WebPart description file for the TextDisplayWebPart control. Click the verbs menu on the custom control (represented by the downward arrow in the title bar), and click Export. Follow the instructions to save a description file for the control. Open the .WebPart description file in an editor, and edit the value of the title property text. Find the <property> element that has the attribute name="Title", and edit the title text that is contained between the opening and closing <property> tags. Now close the Web page, and edit the page source in an editor. Delete the <aspSample:TextDisplayWebPart> control declaration element, then save and close the file.

Load the Web page again in a browser. The TextDisplayWebPart control should not appear, because you removed it. Use the Display Mode drop-down list control and select Catalog to switch the page to catalog mode. Notice that the custom T:System.Web.UI.WebControls.WebParts.CatalogZone control appears, along with the T:System.Web.UI.WebControls.WebParts.ImportCatalogPart control. Click the Browse button to locate the .WebPart description file that you exported for the TextDisplayWebPart control. You can click Upload, select the check box next to the imported control, and click Add to add it to the page. Click Close Catalog to return the page to normal browse mode. The imported control should now appear in the page, and the title that appears in the title bar of the control should be the title text you added to the .WebPart description file.

AspNetHostingPermission

for operating in a hosted environment. Demand value: F:System.Security.Permissions.SecurityAction.LinkDemand; Permission value: F:System.Web.AspNetHostingPermissionLevel.Minimal.

AspNetHostingPermission

for operating in a hosted environment. Demand value: F:System.Security.Permissions.SecurityAction.InheritanceDemand; Permission value: F:System.Web.AspNetHostingPermissionLevel.Minimal.

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: