EditorPart.ApplyChanges Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Zapisuje wartości w kontrolce EditorPart do odpowiednich właściwości w skojarzonej WebPart kontrolce.

public:
 abstract bool ApplyChanges();

public abstract bool ApplyChanges ();

abstract member ApplyChanges : unit -> bool

Public MustOverride Function ApplyChanges () As Boolean

Zwraca

Boolean

true jeśli akcja zapisywania wartości z kontrolki EditorPart do kontrolki WebPart zakończy się powodzeniem; w przeciwnym razie (jeśli wystąpi błąd), false.

Przykłady

W poniższym przykładzie kodu pokazano, jak zaimplementować metodę ApplyChanges w kontrolce niestandardowej EditorPart . Aby zapoznać się z pełnym kodem wymaganym do uruchomienia przykładu, zobacz sekcję Przykład w przeglądzie EditorPart klasy.

Pierwsza część przykładu kodu pokazuje implementację ApplyChanges metody w klasie niestandardowej EditorPart o nazwie TextDisplayEditorPart. Ta metoda pobiera odwołanie do skojarzonej TextDisplayWebPartWebPartToEdit kontrolki przy użyciu właściwości . Następnie aktualizuje wartość TextDisplayWebPart.FontStyle właściwości .

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

Druga część przykładu kodu pokazuje, jak skojarzona kontrolka , TextDisplayWebParttworzy kolekcję skojarzonych EditorPartWebPart kontrolek (w tym przypadku istnieje tylko jedna EditorPart kontrolka o nazwie TextDisplayEditorPart w kolekcji) w implementacji CreateEditorParts metody . Ta metoda jest wykonywana, gdy kontrolka TextDisplayWebPart przechodzi w tryb edycji.

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

Uwagi

Metoda ApplyChanges jest metodą krytyczną w kontrolce EditorPart . Jest ona zdefiniowana jako metoda abstrakcyjna w EditorPart klasie i musi być zaimplementowana przez dziedziczone kontrolki. Celem metody jest zapisanie wartości wprowadzonych przez użytkownika do EditorPart odpowiednich właściwości w WebPart kontrolce WebPartToEdit , do których odwołuje się właściwość .

Metoda jest wywoływana ApplyChanges , gdy użytkownik kliknie przycisk reprezentujący przycisk OK lub czasownik zastosuj w interfejsie użytkownika do edycji.

Uwagi dotyczące implementowania

Klasa pochodząca z EditorPart klasy musi implementować metodę ApplyChanges() . Zaimplementowana metoda pobiera odwołanie do skojarzonej kontrolki przy użyciu WebPartToEdit właściwości , a następnie aktualizuje właściwości tej kontrolki przy użyciu bieżących wartości w kontrolce EditorPart .

Zobacz też

• SyncChanges()
• IWebEditable
• kontrolki składników Web Part ASP.NET