Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Deklarative Syntax des LayoutEditorPart-Webserver-Steuerelements

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Stellt ein Editor-Steuerelement bereit, mit dem Benutzer mehrere layoutorientierte Benutzeroberflächeneigenschaften auf einem zugeordneten WebPart-Steuerelement bearbeiten können.

<asp:LayoutEditorPart
    AccessKey="string"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
                 Inset|Outset"
    BorderWidth="size"
    ChromeState="Normal|Minimized"
    ChromeType="Default|TitleAndBorder|None|TitleOnly|BorderOnly"
    CssClass="string"
    DefaultButton="string"
    Description="string"
    Direction="NotSet|LeftToRight|RightToLeft"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
               Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GroupingText="string"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    ScrollBars="None|Horizontal|Vertical|Both|Auto"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Title="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
    Wrap="True|False"
/>

Die LayoutEditorPart-Klasse stellt ein Editor-Steuerelement dar, dass von der EditorPart-Klasse abgeleitet wird und mit dem Eigenschaften bearbeitet werden, die Auswirkungen auf das Layout eines zugeordneten WebPart-Steuerelements oder GenericWebPart-Steuerelements haben.

Weitere Informationen zum LayoutEditorPart-Steuerelement und zu Webparts-Steuerelementen finden Sie unter ASP.NET Web Parts Pages.

Im folgenden Codebeispiel wird veranschaulicht, wie das LayoutEditorPart-Steuerelement mithilfe des Calendar-Steuerelements deklarativ in einem Webparts-Szenario verwendet wird. Mithilfe der Webseite können Benutzer zum Benutzermodus wechseln, um bestimmte Aspekte des Calendar-Steuerelements zu bearbeiten. Über die Schaltfläche Toggle Scope wird die Seite zwischen Benutzerpersonalisierungsbereich und freigegebenem Personalisierungsbereich hin- und hergeschaltet. Mit den Schaltflächen Bearbeitungsmodus und Durchsuchen-Modus wird die Seite in den entsprechenden Anzeigemodus umgeschaltet. Im <script>-Tagabschnitt der Datei verwenden zwei der Methoden, die Ereignisse behandeln, die Personalization-Eigenschaft, um auf nützliche Member des zugrunde liegenden Objekts zuzugreifen. Diese Methoden verwenden speziell die ToggleScope-Methode und die Scope-Eigenschaft auf dem Objekt, auf das über die Personalization-Eigenschaft zugegriffen wurde.

Damit das Codebeispiel ausgeführt werden kann, müssen Sie auch die Personalisierung von Seiten im freigegebenen Bereich aktivieren. Dazu muss der Datei Web.config in webParts-Element (ASP.NET-Einstellungsschema) ein Eintrag hinzugefügt werden.


<%@ Page Language="C#" %>

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

<script runat="server">
  protected void Button1_Click(object sender, EventArgs e)
  {
    if ((mgr1.Personalization.Scope == PersonalizationScope.User)
        && (mgr1.Personalization.CanEnterSharedScope))
    {
      mgr1.Personalization.ToggleScope();
    }
    else if (mgr1.Personalization.Scope ==
          PersonalizationScope.Shared)
    {
      mgr1.Personalization.ToggleScope();
    }
    else
    {
      // If the user cannot enter shared scope you may want
      // to notify them on the page.
    }
  }



  protected void Button2_Click(object sender, EventArgs e)
  {
    mgr1.DisplayMode = WebPartManager.EditDisplayMode;
  }


  protected void Button3_Click(object sender, EventArgs e)
  {
    mgr1.DisplayMode = WebPartManager.BrowseDisplayMode;
  }


  protected void Page_Load(object sender, EventArgs e)
  {
    Label1.Text = "Scope is: "
      + mgr1.Personalization.Scope.ToString();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head id="head1" runat="server">
    <title>Web Parts Declarative Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:LoginName id="LoginName1" runat="server" />
      <asp:WebPartManager id="mgr1" runat="server">
        <Personalization InitialScope="Shared" Enabled="True" />
      </asp:WebPartManager>
      <asp:WebPartZone id="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar id="Calendar1" runat="server" />
        </ZoneTemplate>
        <CloseVerb Text="Close This Part" />
        <MinimizeVerb Text="Minimize This Part" />
        <EditVerb Text="Edit This Part" />
      </asp:WebPartZone>
      <asp:EditorZone id="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:LayoutEditorPart HorizontalAlign="Center" id="Layout1" runat="server" Title="My Custom Layout" />
          <asp:AppearanceEditorPart id="AppearanceEditorPart1" 
            runat="server" BackColor="LightGray" />
          <asp:BehaviorEditorPart id="BehaviorEditorPart1" 
            runat="server"  />
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button id="Button1" runat="server" Text="Toggle Scope" OnClick="Button1_Click"  />
      <asp:Button id="Button2" runat="server" Text="Edit Mode" OnClick="Button2_Click" />
      <asp:Button id="Button3" runat="server" Text="Browse Mode" OnClick="Button3_Click" />
      <br />
      <asp:Label id="Label1" runat="server" Text="" />
    </div>
    </form>
</body>
</html>



Anzeigen: