IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Anuncia ao serviço de alteração de componente que um componente específico está mudando.
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 -> unitPublic Sub OnComponentChanging (component As Object, member As MemberDescriptor)Parâmetros
- component
- Object
O componente que está prestes a ser alterado.
- member
- MemberDescriptor
O membro que está mudando. Isso se null essa alteração não estiver relacionada a um único membro.
Comentários
Esse método gera o ComponentChanging evento.
A maioria dos designers incluídos no SDK do Windows, bem como o ambiente de tempo de design 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 fazer check-out do arquivo.