IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Anuncia ao serviço de alteração de componentes que um determinado componente está a ser 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 -> unitPublic 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á a mudar. Isto se null esta alteração não estiver relacionada com um único membro.
Observações
Este método eleva o ComponentChanging evento.
A maioria dos designers incluídos no SDK do Windows, bem como no ambiente de design do Visual Studio, normalmente levantam este evento automaticamente; por isso, na maioria das vezes, não é necessário chamar explicitamente este método. Os eventos apropriados IComponentChangeService são automaticamente gerados quando a PropertyDescriptor é usado para alterar o valor de uma propriedade ou quando componentes são adicionados ou removidos do IDesignerHost contentor.
Notas para Implementadores
Este método lança uma exceção se a propriedade não puder ser alterada. Isto não pretende validar os valores de uma determinada propriedade. Em vez disso, destina-se a fornecer um método global para impedir que um componente mude. Por exemplo, se um ficheiro designer for registado no controlo do código-fonte, o handler deste evento normalmente lançaria uma exceção se o utilizador se recusasse a fazer o check-out do ficheiro.