IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Método

Definição

Namespace:

System.ComponentModel.Design

Assembly:

System.ComponentModel.TypeConverter.dll

Anuncia ao serviço de alteração de componente que um componente específico está sendo alterado.

public:
 void OnComponentChanging(System::Object ^ component, System::ComponentModel::MemberDescriptor ^ member);

public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor? member);

abstract member OnComponentChanging : obj * System.ComponentModel.MemberDescriptor -> unit

Public Sub OnComponentChanging (component As Object, member As MemberDescriptor)

Parâmetros

component

Object

O componente que está prestes a mudar.

member

MemberDescriptor

O membro que está sendo alterado. Isso será null se essa alteração não estiver relacionada a um membro único.

Comentários

Esse método gera o ComponentChanging evento.

A maioria dos designers incluídos com o SDK do Windows, bem como o ambiente de tempo de design do Visual Studio, normalmente geram esse evento automaticamente; portanto, na maioria das vezes, você não precisa chamar explicitamente esse método. Os eventos apropriados IComponentChangeService são gerados automaticamente quando um PropertyDescriptor é usado para alterar um valor de propriedade ou componentes são adicionados ou removidos do IDesignerHost contêiner.

Notas aos Implementadores

Esse método gerará uma exceção se a propriedade não puder ser alterada. Isso não se destina a validar os valores de uma propriedade específica. Em vez disso, destina-se a fornecer um método global para impedir que um componente seja alterado. Por exemplo, se um arquivo de designer for verificado no controle do código-fonte, o manipulador desse evento normalmente lançará uma exceção se o usuário se recusasse a marcar o arquivo.

Confira também

• MemberDescriptor