EditorPartCollection Constructeurs

  • Référence

Définition

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

Initialise une nouvelle instance de la classe EditorPartCollection.

Surcharges

EditorPartCollection()

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

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

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

EditorPartCollection()

Initialise une nouvelle instance vide de la classe EditorPartCollection.

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 de et y ajouter EditorPart des EditorPartCollection 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 d'une classe EditorPartCollection en passant dans une collection ICollection de contrôles EditorPart.

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 de contrôles EditorPart.

Exemples

L’exemple de code suivant montre comment créer un personnalisé EditorPartCollection et, même si la collection est en lecture seule, effectuez toujours une opération de traitement par lot pour modifier les contrôles individuels EditorPart dans la collection. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la 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 des 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 transmet 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 est si vous souhaitez effectuer une opération de traitement par lots sur un ensemble entier de EditorPart contrôles, comme la modification du contenu, de l’apparence ou de 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 et, dans le IWebEditable 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, telle qu’un ArrayList objet . Vous pouvez ensuite passer la collection de EditorPart contrôles au EditorPartCollection constructeur pour créer un objet EditorPartCollection , que la EditorZoneBase zone utilise pour configurer tous les contrôles et commencer le processus de modification.

Voir aussi

S’applique à

EditorPartCollection(EditorPartCollection, ICollection)

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

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

ICollection de contrôles EditorPart existants dans une zone.

editorParts
ICollection

ICollection de contrôles EditorPart non présents dans une zone, mais créés par programme.

Voir aussi

S’applique à