EditorPart.SyncChanges Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

İlişkili EditorPart denetimi için bir WebPart denetimden özellik değerlerini alır.

public:
 abstract void SyncChanges();

public abstract void SyncChanges ();

abstract member SyncChanges : unit -> unit

Public MustOverride Sub SyncChanges ()

Örnekler

Aşağıdaki kod örneği, yönteminin SyncChanges özel EditorPart bir denetimde nasıl uygulanduğunu gösterir. Örneği çalıştırmak için gereken kodun tamamı için, sınıfa genel bakışın EditorPart Örnek bölümüne bakın.

Kod örneğinin ilk bölümünde adlı TextDisplayEditorPartözel EditorPart sınıfta yönteminin SyncChanges uygulanması gösterilmektedir. Bu yöntem, özelliğini kullanarak WebPartToEdit ilişkili TextDisplayWebPart denetime bir başvuru alır. Ardından özelliğin TextDisplayWebPart.FontStyle değerini alır ve özel EditorPart denetimdeki açılan liste denetiminde (özellik tarafından TextDisplayEditorPart.PartContentFontStyle başvurulan) hangi öğenin seçildiğini güncelleştirir.

public override void SyncChanges()
{
  TextDisplayWebPart part = 
    (TextDisplayWebPart)WebPartToEdit;
  String currentStyle = part.FontStyle;

  // Select the current font style in the drop-down control.
  foreach (ListItem item in PartContentFontStyle.Items)
  {
    if (item.Value == currentStyle)
    {
      item.Selected = true;
      break;
    }
  }
}

Public Overrides Sub SyncChanges()
  Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
                                         TextDisplayWebPart)
  Dim currentStyle As String = part.FontStyle

  ' Select the current font style in the drop-down control.
  Dim item As ListItem
  For Each item In PartContentFontStyle.Items
    If item.Value = currentStyle Then
      item.Selected = True
      Exit For
    End If
  Next item

End Sub

Kod örneğinin ikinci bölümünde, TextDisplayWebPartilişkili WebPart denetimin yönteminin uygulamasında CreateEditorParts ilişkili EditorPart denetimlerden oluşan bir koleksiyonu (bu örnekte koleksiyonda adlı TextDisplayEditorPart tek bir EditorPart denetim vardır) nasıl oluşturduğu gösterilir. Denetim düzenleme moduna girdiğinde TextDisplayWebPart bu yöntem yürütülür.

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

Açıklamalar

SyncChanges yöntemi, bir denetimdeki kritik bir EditorPart yöntemdir. Sınıfında soyut bir yöntem EditorPart olarak tanımlanır ve devralınan denetimler tarafından uygulanması gerekir. yönteminin amacı, özelliğinde WebPartToEdit başvuruda bulunan denetimden WebPart geçerli değerleri almak ve kullanıcının düzenleyebilmesi için denetimdeki EditorPart alanları bu değerlerle güncelleştirmektir.

yöntemi SyncChanges , ilişkili WebPart denetimdeki değerler her değiştirildiğinde çağrılır. Her EditorPart denetim için, EditorZoneBase denetimi içeren bölge yöntemini çağırdıktan ApplyChanges hemen sonra yöntemini çağırırSyncChanges, böylece denetimdeki EditorPart değerler her zaman ilişkili WebPart denetimdeki değerlerle eşitlenir. Yöntemin SyncChanges çağrıldığı bir diğer durum, bir WebPart denetimin düzenleme moduna girmesidir.

Not

Yöntemi SyncChanges döndürürse falseyöntemi yönteminden sonra ApplyChanges çağrılmaz, çünkü bu durumda bir hata oluştu.

Uygulayanlara Notlar

sınıfından EditorPart türetilen bir sınıf yöntemini uygulamalıdır SyncChanges() . Uygulanan yöntem, özelliğini kullanarak WebPartToEdit ilişkili denetime bir başvuru alır ve ardından denetimi ilişkili WebPart denetimden özellik değerleriyle güncelleştirirEditorPart.

Ayrıca bkz.

• IWebEditable
• ApplyChanges()
• Web Bölümleri Denetimlerini ASP.NET