IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Método
Definição
Anuncia ao serviço de alteração de componente que um componente específico está sendo alterado.Announces to the component change service that a particular component is changing.
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.The component that is about to change.
- member
- MemberDescriptor
O membro que está sendo alterado.The member that is changing. Isso será null se essa alteração não estiver relacionada a um membro único.This is null if this change is not related to a single member.
Comentários
Esse método gera o ComponentChanging evento.This method raises the ComponentChanging event.
A maioria dos designers incluídos na SDK do Windows, bem como no ambiente de tempo de design do Visual Studio, normalmente gera esse evento automaticamente; na maioria das vezes, você não precisa chamar esse método explicitamente.Most designers included with the Windows SDK, as well as the Visual Studio design-time environment, typically raise this event automatically; so most of the time, you do not need to explicitly call this method. Os IComponentChangeService eventos apropriados são gerados automaticamente quando um PropertyDescriptor é usado para alterar um valor de propriedade ou os componentes são adicionados ou removidos do IDesignerHost contêiner.The appropriate IComponentChangeService events are automatically raised when a PropertyDescriptor is used to change a property value or components are added or removed from the IDesignerHost container.
Notas aos Implementadores
Esse método gera uma exceção se a propriedade não puder ser alterada.This method throws an exception if the property cannot be changed. Isso não se destina a validar os valores de uma determinada propriedade.This is not intended to validate the values of a particular property. Em vez disso, ele destina-se a fornecer um método global de impedir que um componente seja alterado.Instead, it is intended to provide a global method of preventing a component from changing. Por exemplo, se um arquivo de Designer for verificado no controle do código-fonte, o manipulador desse evento normalmente lançaria uma exceção se o usuário se recusasse a fazer check-out do arquivo.For example, if a designer file is checked into source code control, this event's handler would typically throw an exception if the user refused to check out the file.