ImportCatalogPart Sınıf

Tanım

public ref class ImportCatalogPart sealed : System::Web::UI::WebControls::WebParts::CatalogPart

public sealed class ImportCatalogPart : System.Web.UI.WebControls.WebParts.CatalogPart

type ImportCatalogPart = class
    inherit CatalogPart

Public NotInheritable Class ImportCatalogPart
Inherits CatalogPart

Devralma

Object

Control

WebControl

Panel

Part

CatalogPart

ImportCatalogPart

Örnekler

Aşağıdaki kod örneği, denetimin ImportCatalogPart Web sayfasında bildirim temelli ve programlı olarak nasıl kullanılacağını gösterir. Örnekte dört bölüm vardır:

• Web Bölümleri sayfasındaki görüntüleme modlarını değiştirmenize olanak tanıyan bir kullanıcı denetimi.

• Denetim ve denetim içeren bir CatalogZoneImportCatalogPart Web sayfası.

• İki özel WebPart denetim içeren bir kaynak kod dosyası.

• Sayfayı bir tarayıcıda yüklediğinizde örneğin nasıl çalıştığını gösteren bir açıklama.

Bu kod örneğinin ilk bölümü, kullanıcıların Web sayfasındaki görüntü modlarını değiştirmesine olanak tanıyan kullanıcı denetimidir. Aşağıdaki kaynak kodu bir dosyaya yerleştirmeniz ve displaymodemenucs.ascx veya Displaymodemenuvb.ascx olarak adlandırmanız gerekir (kullandığınız dile bağlı olarak). Bu denetimdeki görüntü modları ve kaynak kodun açıklaması hakkında ayrıntılı bilgi için bkz . İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.

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

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' 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 Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

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

Kod örneğinin ikinci bölümü Web sayfasıdır. Sayfanın üst kısmında biri kullanıcı denetimi, diğeri de iki özel WebPart denetimi içeren derlenmiş bileşen için iki yönerge bulunurregister. Sayfanın, doğru bildirim temelli öğeler hiyerarşisi ImportCatalogPart içinde iç içe geçmiş denetime bildirim temelli bir başvurusu olduğuna dikkat edin. Ayrıca öğeye bildirim temelli olarak birkaç özellik değeri atandığını <asp:importcatalogpart> da görebilirsiniz. Ayrıca yöntemi, Button1_Click denetimdeki ImportCatalogPart bir dizi özellik değerini güncelleştirir.

Sayfanın WebPartZone denetiminde iki özel WebPart denetim bildirilir. Denetimin <aspSample:userinfowebpart> üzerinde bir exportmode="all" özniteliği vardır. Bu öznitelik, kullanıcıların denetim için bir açıklama dosyasını dışarı aktarmasına olanak tanımak için gereklidir. Bu dosya, açıklama dosyasını kullanarak denetimi içeri aktarmak isteyen diğer kullanıcılar tarafından içeri aktarılabilir.

<%@ 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">

<script runat="server">

  // <snippet3>
  protected void Button1_Click(object sender, EventArgs e)
  {
    ImportCatalogPart1.Title = "Import Server Controls";
    ImportCatalogPart1.BrowseHelpText = "Enter the path to a "
      + "description file.";
    ImportCatalogPart1.UploadButtonText = "Upload Description";
    ImportCatalogPart1.UploadHelpText = "Upload a description file.";
    ImportCatalogPart1.ImportedPartLabelText = "Imported Controls";
    ImportCatalogPart1.PartImportErrorLabelText = "An error occurred " 
      + "during the import process.";

  }
  // </snippet3>
  
  protected void Page_Load(object sender, EventArgs e)
  {
    Button1.Visible = false;
  }

  protected void ImportCatalogPart1_PreRender(object sender, 
    EventArgs e)
  {
    Button1.Visible = true;
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      ImportCatalogPart Control
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server"  />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" >
        <PartTitleStyle BorderWidth="1" 
          Font-Names="Verdana, Arial"
          Font-Size="110%"
          BackColor="LightBlue" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="TextDisplayWebPart1" 
            title = "Text Display WebPart" /> 
          <aspsample:userinfowebpart id="userinfo1" runat="server" 
            Title="User Information" exportmode="all" />
        </zonetemplate>
      </asp:webpartzone> 
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" 
            runat="server" />
        </ZoneTemplate>
      </asp:EditorZone>
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:ImportCatalogPart ID="ImportCatalogPart1" 
            runat="server" 
            Title="My ImportCatalogPart" 
            OnPreRender="ImportCatalogPart1_PreRender"
            BrowseHelpText="Type a path or browse to find a control's 
              description file." 
            UploadButtonText="Upload Description File" 
            UploadHelpText="Click the button to upload the description 
              file."
            ImportedPartLabelText="My User Information WebPart" 
            PartImportErrorLabelText="An error occurred while trying 
              to import a description file."  />
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="Update ImportCatalogPart" 
        OnClick="Button1_Click" />
    </form>
  </body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  ' <snippet3>
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
      ImportCatalogPart1.Title = "Import Server Controls"
      ImportCatalogPart1.BrowseHelpText = "Enter the path to a " _
        & "description file."
      ImportCatalogPart1.UploadButtonText = "Upload Description"
      ImportCatalogPart1.UploadHelpText = "Upload a description file."
      ImportCatalogPart1.ImportedPartLabelText = "Imported Controls"
      ImportCatalogPart1.PartImportErrorLabelText = "An error occurred " _
        & "during the import process."
  End Sub
  ' </snippet3>

  Protected Sub Page_Load(ByVal sender As Object, _
    ByVal e As EventArgs)
      Button1.Visible = false
  End Sub

  Protected Sub ImportCatalogPart1_PreRender(ByVal sender As Object, _
    ByVal e As EventArgs)
      Button1.Visible = true
  End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      ImportCatalogPart Control
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server"  />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" >
        <PartTitleStyle BorderWidth="1" 
          Font-Names="Verdana, Arial"
          Font-Size="110%"
          BackColor="LightBlue" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="TextDisplayWebPart1" 
            title = "Text Display WebPart" /> 
          <aspsample:userinfowebpart id="userinfo1" runat="server" 
            Title="User Information" exportmode="all" />
        </zonetemplate>
      </asp:webpartzone> 
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" 
            runat="server" />
        </ZoneTemplate>
      </asp:EditorZone>
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:ImportCatalogPart ID="ImportCatalogPart1" 
            runat="server" 
            Title="My ImportCatalogPart" 
            OnPreRender="ImportCatalogPart1_PreRender"
            BrowseHelpText="Type a path or browse to find a control's 
              description file." 
            UploadButtonText="Upload Description File" 
            UploadHelpText="Click the button to upload the description 
              file."
            ImportedPartLabelText="My User Information WebPart" 
            PartImportErrorLabelText="An error occurred while trying 
              to import a description file."  />
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="Update ImportCatalogPart" 
        OnClick="Button1_Click" />
    </form>
  </body>
</html>

Kod örneğinin üçüncü bölümü, iki WebPart denetimin kaynak kodudur. Bu denetimlerde bazı özelliklerin WebBrowsable özniteliğiyle işaretlendiğini fark edin. Bu, denetimin PropertyGridEditorPart , denetimler düzenleme modundayken kullanıcının bu özellikleri düzenlemesi için kullanıcı arabirimini (UI) dinamik olarak oluşturmasını sağlar. Özellikler, düzenleme kullanıcı arabirimindeki her denetimin yanında görünen etiketin metnini belirtmek için bir WebDisplayName öznitelikle de işaretlenir. Kod örneğinin çalışması için bu kaynak kodu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin çalışma zamanında dinamik olarak derlenecek App_Code klasörüne yerleştirebilirsiniz. Bu kod örneği dinamik derleme kullanır. Her iki derleme yöntemini de gösteren bir kılavuz için bkz. İzlenecek yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

Adlı TextDisplayWebPart özel denetime Web sayfasında bir <aspSample:TextDisplayWebPart> öğesiyle başvurulur. adlı UserInfoWebPartdiğer denetim de başlangıçta Web sayfasında bildirilir, ancak daha sonra bir denetim için açıklama dosyasını içeri aktarma özelliğini göstermek üzere kaldıracaksınız.

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
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class UserInfoWebPart : WebPart
  {
    HttpServerUtility server = HttpContext.Current.Server;
    private String _userNickName = "Add a nickname.";
    private String _userPetName = "Add a pet name.";
    private DateTime _userSpecialDate = DateTime.Now;
    private Boolean _userIsCurrent = true;
    private JobTypeName _userJobType = JobTypeName.Unselected;
    public enum JobTypeName
    {
      Unselected = 0,
      Support = 1,
      Service = 2,
      Professional = 3, 
      Technical = 4,
      Manager = 5,
      Executive = 6
    }
    Label NickNameLabel;
    Label PetNickNameLabel;
    Label SpecialDateLabel;
    CheckBox IsCurrentCheckBox;
    Label JobTypeLabel;

    // Add the Personalizable and WebBrowsable attributes to the  
    // public properties, so that users can save property values  
    // and edit them with a PropertyGridEditorPart control.
    [Personalizable(), WebBrowsable, WebDisplayName("Nickname")]
    public String NickName
    {
      get 
      { 
        object o = ViewState["NickName"];
        if (o != null)
          return (string)o;
        else
          return _userNickName;        
      } 

      set { _userNickName = server.HtmlEncode(value); }
    }

    [Personalizable(), WebBrowsable, WebDisplayName("Pet Name")]
    public String PetName
    {
      get 
      { 
        object o = ViewState["PetName"];
        if (o != null)
          return (string)o;
        else
          return _userPetName;        
      }

      set { _userPetName = server.HtmlEncode(value); }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Special Day")]
    public DateTime SpecialDay
    {
      get
      {
        object o = ViewState["SpecialDay"];
        if (o != null)
          return (DateTime)o;
        else
          return _userSpecialDate;
      }

      set { _userSpecialDate = value; }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Job Type")]
    public JobTypeName UserJobType
    {
      get
      {
        object o = ViewState["UserJobType"];
        if (o != null)
          return (JobTypeName)o;
        else
          return _userJobType;
      }

      set { _userJobType = (JobTypeName)value; }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Is Current")]
    public Boolean IsCurrent
    {
      get
      {
        object o = ViewState["IsCurrent"];
        if (o != null)
          return (Boolean)o;
        else
          return _userIsCurrent;
      }

      set { _userIsCurrent = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      NickNameLabel = new Label();
      NickNameLabel.Text = this.NickName;
      SetControlAttributes(NickNameLabel);

      PetNickNameLabel = new Label();
      PetNickNameLabel.Text = this.PetName;
      SetControlAttributes(PetNickNameLabel);

      SpecialDateLabel = new Label();
      SpecialDateLabel.Text = this.SpecialDay.ToShortDateString();
      SetControlAttributes(SpecialDateLabel);

      IsCurrentCheckBox = new CheckBox();
      IsCurrentCheckBox.Checked = this.IsCurrent;
      SetControlAttributes(IsCurrentCheckBox);

      JobTypeLabel = new Label();
      JobTypeLabel.Text = this.UserJobType.ToString();
      SetControlAttributes(JobTypeLabel);

      ChildControlsCreated = true;
    }

    private void SetControlAttributes(WebControl ctl)
    {
      ctl.BackColor = Color.White;
      ctl.BorderWidth = 1;
      ctl.Width = 200;
      this.Controls.Add(ctl);
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
      writer.Write("Nickname:");
      writer.WriteBreak();
      NickNameLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Pet Name:");
      writer.WriteBreak();
      PetNickNameLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Special Date:");
      writer.WriteBreak();
      SpecialDateLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Job Type:");
      writer.WriteBreak();
      JobTypeLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Current:");
      writer.WriteBreak();
      IsCurrentCheckBox.RenderControl(writer);
    }
  }

  [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 (!String.IsNullOrEmpty(input.Text))
      {
        _contentText = Context.Server.HtmlEncode(input.Text) + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class UserInfoWebPart
    Inherits WebPart
    Private server As HttpServerUtility = HttpContext.Current.Server
    Private _userNickName As String = "Add a nickname."
    Private _userPetName As String = "Add a pet name."
    Private _userSpecialDate As DateTime = DateTime.Now
    Private _userIsCurrent As [Boolean] = True
    Private _userJobType As JobTypeName = JobTypeName.Unselected

    Public Enum JobTypeName
      Unselected = 0
      Support = 1
      Service = 2
      Professional = 3
      Technical = 4
      Manager = 5
      Executive = 6
    End Enum

    Private NickNameLabel As Label
    Private PetNickNameLabel As Label
    Private SpecialDateLabel As Label
    Private IsCurrentCheckBox As CheckBox
    Private JobTypeLabel As Label

    ' Add the Personalizable and WebBrowsable attributes to the  
    ' public properties, so that users can save property values  
    ' and edit them with a PropertyGridEditorPart control.

    <Personalizable(), WebBrowsable(), WebDisplayName("Nickname")> _
    Public Property NickName() As String
      Get
        Dim o As Object = ViewState("NickName")
        If Not (o Is Nothing) Then
          Return CStr(o)
        Else
          Return _userNickName
        End If
      End Get
      Set(ByVal value As String)
        _userNickName = server.HtmlEncode(value)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Pet Name")> _
    Public Property PetName() As String
      Get
        Dim o As Object = ViewState("PetName")
        If Not (o Is Nothing) Then
          Return CStr(o)
        Else
          Return _userPetName
        End If
      End Get
      Set(ByVal value As String)
        _userPetName = server.HtmlEncode(value)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Special Day")> _
    Public Property SpecialDay() As DateTime
      Get
        Dim o As Object = ViewState("SpecialDay")
        If Not (o Is Nothing) Then
          Return CType(o, DateTime)
        Else
          Return _userSpecialDate
        End If
      End Get

      Set(ByVal value As DateTime)
        _userSpecialDate = value
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Job Type")> _
    Public Property UserJobType() As JobTypeName
      Get
        Dim o As Object = ViewState("UserJobType")
        If Not (o Is Nothing) Then
          Return CType(o, JobTypeName)
        Else
          Return _userJobType
        End If
      End Get
      Set(ByVal value As JobTypeName)
        _userJobType = CType(value, JobTypeName)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Is Current")> _
    Public Property IsCurrent() As [Boolean]
      Get
        Dim o As Object = ViewState("IsCurrent")
        If Not (o Is Nothing) Then
          Return CType(o, [Boolean])
        Else
          Return _userIsCurrent
        End If
      End Get
      Set(ByVal value As [Boolean])
        _userIsCurrent = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      NickNameLabel = New Label()
      NickNameLabel.Text = Me.NickName
      SetControlAttributes(NickNameLabel)

      PetNickNameLabel = New Label()
      PetNickNameLabel.Text = Me.PetName
      SetControlAttributes(PetNickNameLabel)

      SpecialDateLabel = New Label()
      SpecialDateLabel.Text = Me.SpecialDay.ToShortDateString()
      SetControlAttributes(SpecialDateLabel)

      IsCurrentCheckBox = New CheckBox()
      IsCurrentCheckBox.Checked = Me.IsCurrent
      SetControlAttributes(IsCurrentCheckBox)

      JobTypeLabel = New Label()
      JobTypeLabel.Text = Me.UserJobType.ToString()
      SetControlAttributes(JobTypeLabel)

      ChildControlsCreated = True

    End Sub

    Private Sub SetControlAttributes(ByVal ctl As WebControl)
      ctl.BackColor = Color.White
      ctl.BorderWidth = 1
      ctl.Width = 200
      Me.Controls.Add(ctl)
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
      writer.Write("Nickname:")
      writer.WriteBreak()
      NickNameLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Pet Name:")
      writer.WriteBreak()
      PetNickNameLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Special Date:")
      writer.WriteBreak()
      SpecialDateLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Job Type:")
      writer.WriteBreak()
      JobTypeLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Current:")
      writer.WriteBreak()
      IsCurrentCheckBox.RenderControl(writer)

    End Sub

  End Class


  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If String.IsNullOrEmpty(input.Text) = False Then
        _contentText = Context.Server.HtmlEncode(input.Text) + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

Şimdi kod örneğini çalıştırın. Web sayfasını bir tarayıcıda yükleyin. İlk adım denetimi düzenlemektir UserInfoWebPart . Görüntüleme Modu açılan liste denetimini kullanın ve Düzenle'yi seçerek sayfayı düzenleme moduna geçirin. Denetimin fiiller menüsüne UserInfoWebPart (başlık çubuğundaki aşağı ok) tıklayın ve ardından Düzenle'ye tıklayın. Düzenleme kullanıcı arabirimi görüntülendiğinde, alan değerlerini düzenlemek için kullanabileceğiniz denetimin altında UserInfoWebPart çeşitli düzenleme denetimleri görünür. Bazı alanları düzenleyin, Tamam'a tıklayın ve sayfayı göz atma moduna döndürmek için Görüntü Modu açılan listesini kullanın.

İkinci adım bir dışarı aktarmaktır. Denetim için UserInfoWebPart Web Bölümü açıklama dosyası. Özel denetimdeki fiiller menüsüne tıklayın (başlık çubuğundaki aşağı okla gösterilir) ve Dışarı Aktar'a tıklayın. Bir kaydetmek için yönergeleri izleyin. Denetim için Web Bölümü açıklama dosyası. Şimdi Web sayfasını kapatın ve bir düzenleyicide sayfa kaynağını düzenleyin. <aspSample:userinfowebpart> Denetim bildirimi öğesini silin, ardından dosyayı kaydedin ve kapatın. (Denetimi sayfaya içeri aktarabilmek için bu adımı henüz UserInfoWebPart denetimi olmayan bir kullanıcının benzetimini yapmak için yapıyorsunuz).

Web sayfasını bir tarayıcıda yeniden yükleyin. Denetimi UserInfoWebPart kaldırdığınızdan, denetim görüntülenmemelidir. Görüntüleme Modu açılan liste denetimini kullanın ve Katalog'a tıklayarak sayfayı katalog moduna geçirin. Denetimde ImportCatalogPartGözat düğmesine tıklayın ve öğesine gidin. Oluşturduğunuz Web Bölümü dosyası, ardından Karşıya Yükle düğmesine tıklayın. Denetimin yanında bir onay kutusu bulunan bir başvuru görünmelidir. Denetimi sayfaya eklemek için onay kutusunu seçin ve ekle'ye tıklayın.

Sayfanın bu görünümündeyken, denetimdeki bir dizi özellik değerini ImportCatalogPart program aracılığıyla güncelleştirmenin etkisini görmek için sayfanın alt kısmındaki ImportCatalogPart'ı Güncelleştir düğmesine tıklayın. Düğmeye tıkladıktan sonra kullanıcı arabiriminde çeşitli özelliklerin nasıl değiştirildiğini gözlemleyin.

Son olarak, katalog modundan çıkmak ve sayfayı göz atma moduna döndürmek için Kapat'a tıklayın. Denetim UserInfoWebPart , daha önce dışarı aktardığınızda sahip olduğu değerleri içeren sayfada görünmelidir.

Açıklamalar

Denetim, ImportCatalogPart kullanıcıların bir denetim veya sunucu denetimindeki ayarları açıklayan ve WebPart kullanıcının bir bölgeye eklemek istediği bir WebPartZoneBase açıklama dosyasını içeri aktarmasına olanak tanır.

Kullanıcı bir açıklama dosyasını içeri aktardıktan sonra, WebPart dosyada başvuruda bulunulmuş denetim denetimin ImportCatalogPart içinde görünür ve kullanıcı denetimi sayfaya ekleyebilir.

Açıklama dosyası denetimin kendisiyle aynı değildir. ile biten bir XML dosyasıdır. Web Bölümü uzantısı ve denetimin durumunu açıklayan ad/değer çiftleri (çoğunlukla özellik değerleri) içerir. Açıklama dosyası, Web Bölümleri Denetimi Açıklama Dosyaları konusunda açıklandığı gibi belirtilen XML biçimine göre oluşturulur.

Açıklama dosyasının başvurduğu denetime gelince, bir derlemede derlenebilir veya .ascx dosyasında tanımlanan bir kullanıcı denetimi olabilir. Her iki durumda da, içeri aktarılan açıklama dosyasında başvuruda bulunulmuş denetim, denetimi içeri aktarmaya çalışan sayfayı barındıran Web sunucusunda bulunmalıdır. Açıklama dosyası, denetimi içeren denetim adına ve derlemeye (veya dosyaya) başvurur ve açıklama dosyası denetimin özellik değerlerini, görünümünü ve davranışını etkileyen ayarları içerir.

Denetim, ImportCatalogPart kullanıcıların denetimlerle ilgili ayarları paylaşmasına olanak tanır. Karmaşık bir denetimin birçok özelliği ve ayarı olabilir. Örneğin, büyük bir şirket içindeki tipik bir intranet sitesinde özel WebPart denetim, veritabanı bağlantıları, departman bilgileri vb. gibi kullanıcıların ortamına özgü değerleri tutan bir dizi özellik içerebilir. Denetim, görünümünü etkileyen bir dizi özellik de içerebilir. Bir kullanıcı, belirli bir sitedeki denetimi kişiselleştirebilir ve düzgün çalışmasını sağlayabilir, denetim için bir açıklama dosyasını dışarı aktarabilir ve ardından açıklama dosyasını diğer kullanıcılarla paylaşabilir. Bu kullanıcılar, dosyayı içeri aktararak tam olarak yapılandırılmış denetimi kişiselleştirmelerine izin verilen diğer intranet sitelerine ekleyebilir. Denetimi içeren derlenmiş derleme veya kullanıcı denetim dosyası, sitelerini barındıran Web sunucusunda mevcut olduğu sürece, kullanıcılar denetimi diğer Web sitelerine ekleyebilir.

Kullanıcıların bir açıklama dosyasını (ve dolayısıyla ilişkili sunucu denetimini) Web sayfasına içeri aktardığı mekanizma, sayfa geliştiricisinin ImportCatalogPart Web sayfasına eklemesi gereken denetimdir. Kullanıcı sayfayı katalog görüntüleme moduna geçtiğinde ImportCatalogPart denetim görüntülenir ve kullanıcı bu denetimi kullanarak öğesine göz atabilir. İçeri aktarmak istedikleri sunucu denetimine karşılık gelen Web Bölümü açıklama dosyası. Kullanıcı arabirimini ve denetim tarafından ImportCatalogPart sağlanan yönergeleri izleyerek, kullanıcı web sayfasına istenen sunucu denetimini ekleyebilir ve görünümü ve özellikleri içeri aktarılan açıklama dosyasında belirtildiği gibi tam olarak yapılandırılır.

Bir WebPart denetimin açıklama dosyasının içeri aktarılabilmesi için önce kullanıcının mevcut WebPart bir denetimi temel alarak dosyayı oluşturması (dışarı aktarması) gerekir. Aşağıdaki koşullar karşılanırsa bir açıklama dosyası denetim için dışarı aktarılabilir:

• Denetimin özniteliğiyle Personalizable işaretlenmiş özellikleri vardır.

• Web.config dosyasının öğesinde enableExport<webParts> öznitelik değeri olarak ayarlanmıştırtrue.

• Geliştirici, denetimdeki özelliğinin ExportMode değerini, dışarı aktarmayı yasaklayan varsayılan değeri dışında bir değere Noneayarlar. ExportMode Özellik değeri olarak ayarlanırsaNonSensitiveData, kullanıcı bir açıklama dosyasını dışarı aktardığında özniteliği olan bir PersonalizableIsSensitive parametre içeren herhangi bir özellik dışarı aktarılmaz. Bu, denetim geliştiricilerinin belirli durumlarda bağlantı dizeleri gibi hassas verilerin dışarı aktarılmasını engellemesini sağlar.

Kullanıcı, denetimin fiiller menüsünde görüntülenen dışarı aktarma fiiline tıklayarak ve kaydetme yönergelerini izleyerek dışarı aktarma için etkinleştirilmiş bir denetimi dışarı aktarabilir. Denetim için Web Bölümü açıklama dosyası. Diğer kullanıcılar bu dosyayı içeri aktararak kendi denetim örneklerini yapılandırabilir.

ImportCatalogPart sınıfı çeşitli özellikler içerir. özelliği, BrowseHelpText açıklama dosyasını bulmak için göz atarken kullanıcılara yönelik yönergeler içeren metin içerir. özelliği, ImportedPartLabelText içeri aktarılan denetim için denetim içinde ImportCatalogPart göründüğü şekilde etiket görevi görecek bir metin içerir. , PartImportErrorLabelText denetim açıklaması içeri aktarılırken bir hata oluşursa görüntülenen metni içerir. özelliği, Title geliştirici bir başlık atamazsa bir ImportCatalogPart denetim için varsayılan başlık atamak üzere temel özelliği geçersiz kılar. özelliği, UploadButtonText kullanıcının açıklama dosyasını karşıya yüklemek için tıklattığını düğmenin metnini ve UploadHelpText karşıya yükleme işlemine yönelik yönergeleri içerir.

ImportCatalogPart sınıfı ayrıca birkaç benzersiz yöntem içerir. GetAvailableWebPartDescriptions yöntemi, katalogdaki her WebPart denetim için bir WebPartDescription nesne alır ve bu da bir ImportCatalogPart denetimin bir örneğini oluşturmak zorunda kalmadan her sunucu denetimiyle ilgili bilgileri görüntülemesini sağlar. yöntemi, GetWebPart yöntemine geçirilen açıklamaya göre belirli WebPart bir denetimin örneğini alır.

Denetimin kullanılmasıyla ImportCatalogPart ilgili bazı doğal riskler vardır. Örneklerden biri, içeri aktarmak için kullanılan açıklama dosyaları aracılığıyla kötü amaçlı verileri Web uygulamanıza aktarma olasılığıdır. Birisi açıklama dosyasına dize özelliğinin değeri olarak kötü amaçlı betik kodu yerleştirmişse, bir kullanıcı açıklama dosyasını içeri aktarıp başvurulan sunucu denetimini bir Web sayfasına eklediğinde bu betik yürütülebilir. Açıklama dosyalarını kötü amaçlı verilerle içeri aktarma riskini en aza indirmek için, dize türündeki özelliklere sahip sunucu denetimleri her zaman özellik verilerini kodlamalıdır. Bir diğer risk de türlerin açıklama dosyaları aracılığıyla içeri aktarılmasıdır (bkz . Web Bölümleri Denetimi Açıklama Dosyaları). Kötü amaçlı bir kullanıcı içine çok sayıda derleme AppDomainyüklemek için istek gönderebilir ve bu da aşırı miktarda bellek tüketilmesine neden olur.

İçeri aktarmayla ilgili riskleri önlemek için içeri aktarma özelliğini veya ImportCatalogPart denetimi kullanmayarak özelliği tamamen devre dışı bırakabilirsiniz. Ya da kullanıcıların denetime erişebileceklerini sınırlayabilirsiniz. Rol yönetimini kullanarak bunu program aracılığıyla yapabilirsiniz (bkz. Rolleri Kullanarak Yetkilendirmeyi Yönetme). Örneğin, sayfa yüklendiğinde kullanıcının yönetici rolü gibi belirli bir rolde olup olmadığını test edebilirsiniz. Kullanıcı roldeyse, denetimi o kullanıcının sayfasına program aracılığıyla ekleyebilirsiniz ImportCatalogPart . Ayrıca, denetimi kullanabilecek kullanıcı kümesini sınırlamak için bildirim temelli bir yaklaşım da kullanabilirsiniz ImportCatalogPart . Katalog içeren web sayfanıza iki CatalogZone denetim yerleştirebilirsiniz: biri içeri aktarabilen kullanıcılar için, diğeri de içeri aktaramayanlar için. İçeri aktarabilen kullanıcıların bölgesi denetimi içerir ImportCatalogPart . Bölge bir LoginView denetimin içine yerleştirilebilir ve bu da bölgedeki denetimin kullanımını yalnızca belirttiğiniz kimliği doğrulanmış kullanıcılar veya rollerle sınırlandırmanızı sağlar.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• PageCatalogPart
• DeclarativeCatalogPart
• Web Bölümleri Denetimi Açıklama Dosyaları
• Web Bölümleri Denetimlerini ASP.NET