Sdílet prostřednictvím

EditorPartCollection Konstruktory

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Inicializuje novou instanci EditorPartCollection třídy.

Přetížení

EditorPartCollection()

Inicializuje prázdnou novou instanci EditorPartCollection třídy.
EditorPartCollection(ICollection)

Inicializuje novou instanci EditorPartCollection třídy předáním ICollection kolekce ovládacích EditorPart prvků.
EditorPartCollection(EditorPartCollection, ICollection)

Inicializuje novou instanci EditorPartCollection třídy předáním EditorPartCollection kolekce ovládacích EditorPart prvků a ICollection kolekce dalších EditorPart ovládacích prvků.

EditorPartCollection()

Inicializuje prázdnou novou instanci EditorPartCollection třídy.

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

Poznámky

Konstruktor EditorPartCollection inicializuje prázdnou EditorPartCollection instanci třídy. Toto přetížení konstruktoru interně EditorZone používá třída ve své CreateEditorParts metodě k vytvoření prázdného objektu kolekce. Zóna pak vytvoří instance všech EditorPart ovládacích prvků deklarovaných v šabloně podřízené zóny a pomocí interní metody je přidá do kolekce.

Toto přetížení konstruktoru EditorPartCollection nelze použít k vytvoření nové instance a přidání EditorPart ovládacích EditorPartCollection prvků do ní. Místo toho musíte pro konstruktor použít jedno z dalších přetížení EditorPartCollection .

Viz také

Platí pro

EditorPartCollection(ICollection)

Inicializuje novou instanci EditorPartCollection třídy předáním ICollection kolekce ovládacích EditorPart prvků.

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)

Parametry

editorParts
ICollection

Funkce ICollection ovládacích EditorPart prvků.

Příklady

Následující příklad kódu ukazuje, jak vytvořit vlastní EditorPartCollection a i když je kolekce jen pro čtení, stále provést dávkovou operaci ke změně jednotlivých EditorPart ovládacích prvků v kolekci. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v přehledu EditorPartCollection třídy.

Kód v Button1_Click události vytvoří ArrayList objekt, přidá do objektu dva ze tří EditorPart ovládacích prvků na stránce a pak pomocí konstruktoru EditorPartCollection vytvoří nový EditorPartCollection objekt. Ukazuje také, jak můžete provádět změny v podkladových ovládacích EditorPart prvcích, i když je kolekce jen pro čtení.

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

Stránku můžete načíst v prohlížeči a přepnout ji do režimu úprav výběrem možnosti Upravit v ovládacím prvku rozevíracího seznamu Režim zobrazení . Můžete kliknout na nabídku sloves (šipka dolů) v záhlaví TextDisplayWebPart ovládacího prvku a kliknutím na Upravit ovládací prvek upravit. Když je uživatelské rozhraní pro úpravy viditelné, uvidíte všechny EditorPart ovládací prvky. Kliknutím na tlačítko Vytvořit EditorPartCollection zobrazíte efekty u dvou EditorPart ovládacích prvků, které jsou přidány do objektu EditorPartCollection .

Poznámky

Konstruktor EditorPartCollection inicializuje instanci EditorPartCollection třídy a předává kolekci ovládacích EditorPart prvků. Toto je jedno přetížení konstruktoru EditorPartCollection , které můžete použít k vytvoření nového EditorPartCollection objektu a přidání EditorPart ovládacích prvků do něj.

I když EditorPartCollection je instance vytvořená konstruktorem jen pro čtení, můžete k jednotlivým EditorPart ovládacím prvkům v kolekci přistupovat programově a volat jejich vlastnosti a metody.

Jedním z běžných scénářů použití konstruktoru EditorPartCollection je, pokud chcete provést nějakou dávkovou operaci s celou sadou ovládacích EditorPart prvků, jako je například změna obsahu, vzhledu nebo umístění související skupiny z nich.

Dalším běžným scénářem použití konstruktoru EditorPartCollection je vývoj vlastních EditorPart ovládacích prvků, které chcete přidružit k ovládacímu prvku serveru, aby uživatelé mohli upravovat vlastní vlastnosti ovládacího prvku. V tomto scénáři musí ovládací prvek serveru implementovat IWebEditable rozhraní a jako součást této úlohy musí implementovat metodu CreateEditorParts . Chcete-li v této metodě povolit úpravu serverového ovládacího prvku vlastním EditorPart ovládacím prvkům, musíte ovládací prvky přidat EditorPart do ICollection instance, například ArrayList objektu. Pak můžete předat kolekci ovládacích EditorPart prvků konstruktoru EditorPartCollection a vytvořit nový EditorPartCollection objekt, který EditorZoneBase zóna používá k nastavení všech ovládacích prvků a zahájení procesu úprav.

Viz také

Platí pro

EditorPartCollection(EditorPartCollection, ICollection)

Inicializuje novou instanci EditorPartCollection třídy předáním EditorPartCollection kolekce ovládacích EditorPart prvků a ICollection kolekce dalších EditorPart ovládacích prvků.

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)

Parametry

existingEditorParts
EditorPartCollection

An ICollection ze stávajících EditorPart ovládacích prvků v zóně.

editorParts
ICollection

An ICollection z ovládacích EditorPart prvků, které nejsou v zóně, ale vytvořené programově.

Viz také

Platí pro