EditorPart.ApplyChanges Metoda

Reference

Definice

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

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Uloží hodnoty v ovládacím prvku EditorPart do odpovídajících vlastností v přidruženém WebPart ovládacím prvku.

public:
 abstract bool ApplyChanges();

public abstract bool ApplyChanges ();

abstract member ApplyChanges : unit -> bool

Public MustOverride Function ApplyChanges () As Boolean

Návraty

Boolean

true pokud je akce ukládání hodnot z EditorPart ovládacího prvku do WebPart ovládacího prvku úspěšná; v opačném případě (pokud dojde k chybě), false.

Příklady

Následující příklad kódu ukazuje, jak implementovat metodu ApplyChanges ve vlastním EditorPart ovládacím prvku. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v přehledu EditorPart třídy.

První část příkladu kódu ukazuje implementaci ApplyChanges metody ve vlastní EditorPart třídě s názvem TextDisplayEditorPart. Tato metoda získá odkaz na přidružený TextDisplayWebPart ovládací prvek pomocí WebPartToEdit vlastnosti . Potom aktualizuje hodnotu TextDisplayWebPart.FontStyle vlastnosti.

public override bool ApplyChanges()
{
  TextDisplayWebPart part = 
    (TextDisplayWebPart)WebPartToEdit;
  // Update the custom WebPart control with the font style.
  part.FontStyle = PartContentFontStyle.SelectedValue;

  return true;
}

Public Overrides Function ApplyChanges() As Boolean
  Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
                                         TextDisplayWebPart)
  ' Update the custom WebPart control with the font style.
  part.FontStyle = PartContentFontStyle.SelectedValue

  Return True

End Function

Druhá část příkladu kódu ukazuje, jak přidružený WebPart ovládací prvek , vytvoří kolekci přidružených EditorPart ovládacích prvků (v tomto případě je v kolekci pouze jeden EditorPart ovládací prvek s názvemTextDisplayEditorPart) v implementaci CreateEditorPartsTextDisplayWebPartmetody. Tato metoda se spustí, TextDisplayWebPart když ovládací prvek přejde do režimu úprav.

public override EditorPartCollection CreateEditorParts()
{
  ArrayList editorArray = new ArrayList();
  TextDisplayEditorPart edPart = new TextDisplayEditorPart();
  edPart.ID = this.ID + "_editorPart1";
  editorArray.Add(edPart);
  EditorPartCollection editorParts = 
    new EditorPartCollection(editorArray);
  return editorParts;
}

public override object WebBrowsableObject
{
  get { return this; }
}

Public Overrides Function CreateEditorParts() _
                            As EditorPartCollection
  Dim editorArray As New ArrayList()
  Dim edPart as New TextDisplayEditorPart()
  edPart.ID = Me.ID & "_editorPart1"
  editorArray.Add(edPart)
  Dim editorParts As New EditorPartCollection(editorArray)
  Return editorParts

End Function

Public Overrides ReadOnly Property WebBrowsableObject() _
                                    As Object
  Get
    Return Me
  End Get
End Property

Poznámky

Metoda ApplyChanges je kritickou metodou EditorPart ovládacího prvku. Je definován jako abstraktní metoda ve EditorPart třídě a musí být implementována zděděnými ovládacími prvky. Účelem metody je uložit hodnoty, které uživatel zadal do EditorPart ovládacího prvku, do odpovídajících vlastností v ovládacím WebPart prvku, na který odkazuje vlastnost WebPartToEdit .

Metoda ApplyChanges je volána, když uživatel klikne na tlačítko představující OK nebo příkaz použít v uživatelském rozhraní pro úpravy.

Poznámky pro implementátory

Třída, která je odvozena z EditorPart třídy musí implementovat metodu ApplyChanges() . Implementovaná metoda získá odkaz na přidružený ovládací prvek pomocí WebPartToEdit vlastnosti a poté aktualizuje vlastnosti tohoto ovládacího prvku aktuálními hodnotami v ovládacím EditorPart prvku.

Platí pro

Sdílet prostřednictvím