Langue

EditorPartCollection Constructeurs

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Initialise une nouvelle instance de la classe EditorPartCollection.

Surcharges

Nom Description
EditorPartCollection()

Initialise une nouvelle instance vide de la EditorPartCollection classe.
EditorPartCollection(ICollection)

Initialise une nouvelle instance de la EditorPartCollection classe en passant une ICollection collection de EditorPart contrôles.
EditorPartCollection(EditorPartCollection, ICollection)

Initialise une nouvelle instance de la EditorPartCollection classe en passant une EditorPartCollection collection de EditorPart contrôles et une ICollection collection de contrôles supplémentaires EditorPart .

EditorPartCollection()

Initialise une nouvelle instance vide de la EditorPartCollection classe.

public:
 EditorPartCollection();
public EditorPartCollection();
Public Sub New ()

Remarques

Le EditorPartCollection constructeur initialise une instance vide de la EditorPartCollection classe. Cette surcharge du constructeur est utilisée en interne par la EditorZone classe dans sa CreateEditorParts méthode pour créer un objet de collection vide. La zone crée ensuite des instances de tous les EditorPart contrôles déclarés dans le modèle de zone enfant et utilise une méthode interne pour les ajouter à la collection.

Vous ne pouvez pas utiliser cette surcharge du EditorPartCollection constructeur pour créer une nouvelle instance et EditorPartCollection y ajouter EditorPart des contrôles. Vous devez utiliser l’une des autres surcharges pour le constructeur à la EditorPartCollection place.

Voir aussi

S’applique à

EditorPartCollection(ICollection)

Initialise une nouvelle instance de la EditorPartCollection classe en passant une ICollection collection de EditorPart contrôles.

public:
 EditorPartCollection(System::Collections::ICollection ^ editorParts);
public EditorPartCollection(System.Collections.ICollection editorParts);
new System.Web.UI.WebControls.WebParts.EditorPartCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Sub New (editorParts As ICollection)

Paramètres

editorParts
ICollection

ICollection ContrôleEditorPart.

Exemples

L’exemple de code suivant montre comment créer une collection personnalisée EditorPartCollection et, même si la collection est en lecture seule, effectuez toujours une opération de traitement par lots pour modifier les contrôles individuels EditorPart de la collection. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de vue d’ensemble de la EditorPartCollection classe.

Le code de l’événement Button1_Click crée un ArrayList objet, ajoute deux des trois EditorPart contrôles de la page à l’objet, puis crée un EditorPartCollection objet à l’aide du EditorPartCollection constructeur. Il montre également comment apporter des modifications aux contrôles sous-jacents EditorPart , même si la collection est en lecture seule.

<!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)
  {
    ArrayList list = new ArrayList(2);
    list.Add(AppearanceEditorPart1);
    list.Add(PropertyGridEditorPart1);
    // Pass an ICollection object to the constructor.
    EditorPartCollection myParts = new EditorPartCollection(list);
    foreach (EditorPart editor in myParts)
    {
      editor.BackColor = System.Drawing.Color.LightBlue;
      editor.Description = "My " + editor.DisplayTitle + " editor.";
    }

    // Use the IndexOf property to locate an EditorPart control.
    int propertyGridPart = myParts.IndexOf(PropertyGridEditorPart1);
    myParts[propertyGridPart].ChromeType = PartChromeType.TitleOnly;

    // Use the Contains method to see if an EditorPart exists.
    if(!myParts.Contains(LayoutEditorPart1))
      LayoutEditorPart1.BackColor = System.Drawing.Color.LightYellow;
    
    // Use the CopyTo method to create an array of EditorParts.
    EditorPart[] partArray = new EditorPart[3];
    partArray[0] = LayoutEditorPart1;
    myParts.CopyTo(partArray,1);
    Label1.Text = "<h3>EditorParts in Custom Array</h3>";
    foreach (EditorPart ePart in partArray)
    {
      Label1.Text += ePart.Title + "<br />";
    }

  }

</script>

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

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim list As New ArrayList(2)
    list.Add(AppearanceEditorPart1)
    list.Add(PropertyGridEditorPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New EditorPartCollection(list)
    Dim editor As EditorPart
    For Each editor In myParts
      editor.BackColor = System.Drawing.Color.LightBlue
      editor.Description = "My " + editor.DisplayTitle + " editor."
    Next editor
    
    ' Use the IndexOf property to locate an EditorPart control.
    Dim propertyGridPart As Integer = _
      myParts.IndexOf(PropertyGridEditorPart1)
    myParts(propertyGridPart).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if an EditorPart exists.
    If Not myParts.Contains(LayoutEditorPart1) Then
      LayoutEditorPart1.BackColor = System.Drawing.Color.LightYellow
    End If
    
    ' Use the CopyTo method to create an array of EditorParts.
    Dim partArray(2) As EditorPart
    partArray(0) = LayoutEditorPart1
    myParts.CopyTo(partArray, 1)
    Label1.Text = "<h3>EditorParts in Custom Array</h3>"
    Dim ePart As EditorPart
    For Each ePart In partArray
      Label1.Text += ePart.Title + "<br />"
    Next ePart

  End Sub

</script>

Vous pouvez charger la page dans un navigateur et basculer la page en mode édition en sélectionnant Modifier dans le contrôle de liste déroulante Mode d’affichage . Vous pouvez cliquer sur le menu verbes (flèche vers le bas) dans la barre de titre du TextDisplayWebPart contrôle, puis cliquer sur Modifier pour modifier le contrôle. Lorsque l’interface utilisateur de modification est visible, vous pouvez voir tous les EditorPart contrôles. Cliquez sur le bouton Créer EditorPartCollection pour afficher les effets sur les deux EditorPart contrôles ajoutés à l’objet EditorPartCollection .

Remarques

Le EditorPartCollection constructeur initialise une instance de la EditorPartCollection classe et passe dans une collection de EditorPart contrôles. Il s’agit d’une surcharge du EditorPartCollection constructeur que vous pouvez utiliser pour créer un EditorPartCollection objet et y ajouter EditorPart des contrôles.

Même si l’instance EditorPartCollection créée par le constructeur est en lecture seule, vous pouvez toujours accéder aux contrôles individuels EditorPart de la collection par programmation et appeler leurs propriétés et méthodes.

L’un des scénarios courants d’utilisation du EditorPartCollection constructeur serait si vous souhaitez effectuer une opération de traitement par lots sur un ensemble entier de EditorPart contrôles, tels que la modification du contenu, l’apparence ou la position d’un groupe associé d’entre eux.

Un autre scénario courant pour l’utilisation du EditorPartCollection constructeur consiste à développer des contrôles personnalisés EditorPart que vous souhaitez associer à un contrôle serveur, afin que les utilisateurs puissent modifier des propriétés personnalisées sur votre contrôle. Dans ce scénario, votre contrôle serveur doit implémenter l’interface IWebEditable et, dans le cadre de cette tâche, il doit implémenter la CreateEditorParts méthode. Dans cette méthode, pour permettre aux contrôles personnalisés EditorPart de modifier votre contrôle serveur, vous devez ajouter les EditorPart contrôles à une ICollection instance, comme un ArrayList objet. Vous pouvez ensuite passer la collection de EditorPart contrôles au EditorPartCollection constructeur pour créer un EditorPartCollection objet, que la EditorZoneBase zone utilise pour configurer tous les contrôles et commencer le processus d’édition.

Voir aussi

S’applique à

EditorPartCollection(EditorPartCollection, ICollection)

Initialise une nouvelle instance de la EditorPartCollection classe en passant une EditorPartCollection collection de EditorPart contrôles et une ICollection collection de contrôles supplémentaires EditorPart .

public:
 EditorPartCollection(System::Web::UI::WebControls::WebParts::EditorPartCollection ^ existingEditorParts, System::Collections::ICollection ^ editorParts);
public EditorPartCollection(System.Web.UI.WebControls.WebParts.EditorPartCollection existingEditorParts, System.Collections.ICollection editorParts);
new System.Web.UI.WebControls.WebParts.EditorPartCollection : System.Web.UI.WebControls.WebParts.EditorPartCollection * System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Sub New (existingEditorParts As EditorPartCollection, editorParts As ICollection)

Paramètres

existingEditorParts
EditorPartCollection

Contrôle ICollection existant EditorPart dans une zone.

editorParts
ICollection

Contrôle ICollection non EditorPart dans une zone, mais créé par programmation.

Voir aussi

S’applique à