PropertyDescriptor.ResetValue(Object) Yöntem

Tanım

Türetilmiş bir sınıfta geçersiz kılındığında, bileşenin bu özelliğinin değerini varsayılan değere sıfırlar.

public:
 abstract void ResetValue(System::Object ^ component);
public abstract void ResetValue(object component);
abstract member ResetValue : obj -> unit
Public MustOverride Sub ResetValue (component As Object)

Parametreler

component
Object

Varsayılan değere sıfırlanacak özellik değerine sahip bileşen.

Açıklamalar

Bu yöntem genellikle yansıma yoluyla uygulanır.

Bu yöntem, özelliğinin aşağıdaki öncelik sırasına göre sıfırlanması gereken değeri belirler:

  1. Bu özellik için gölgeli bir özellik var.

  2. Bu özellik için bir DefaultValueAttribute vardır.

  3. Uyguladığınız bir "ResetMyProperty" yöntemi vardır; burada "MyProperty", geçirdiğiniz özelliğin adıdır.

Bu yöntem aşağıdaki sırayla otomatik olarak bir DesignerTransaction oluşturur:

  1. yöntemi, değişiklikleri temsil eden yeni IDesignerHost.CreateTransaction bir oluşturmak için yöntemini çağırırDesignerTransaction.

  2. yöntemi, işlemin başladığını ve değişikliklerin gerçekleşmek üzere olduğunu belirtmek için yöntemini çağırır IComponentChangeService.OnComponentChanging .

  3. yöntemi, özelliğini bu yöntemin denetim sırası tarafından belirlenen değere sıfırlar.

  4. yöntemi, değişikliklerin gerçekleştiğini IComponentChangeService.OnComponentChanged belirtmek için yöntemini çağırır.

  5. yöntemi, işlemin tamamlandığını belirtmek için öğesini çağırır DesignerTransaction.Commit .

İşlemin amacı, destek Undo ve Redo işlevselliği sağlamaktır.

Uygulayanlara Notlar

Türetilmiş bir sınıfta geçersiz kılındığında, bu yöntem bir DefaultValueAttributearar. Bir tane bulursa, özelliğin değerini bulunan değerine DefaultValueAttribute ayarlar. Bu yöntem bir DefaultValueAttributebulamazsa, uygulamanız gereken bir "ResetMyProperty" yöntemini arar. Bu bulunursa, ResetValue(Object) yöntemi onu çağırır. ResetValue(Object) Uyguladığınız bir DefaultValueAttribute veya "ResetMyProperty" yöntemini bulamazsa, işlem gerçekleştirmez.

Şunlara uygulanır

Ayrıca bkz.