TsgcWebSocketHTTPServerEventos › OnHTTPUploadBeforeSaveFile

OnHTTPUploadBeforeSaveFile Evento

Disparado logo antes de um arquivo extraído de um upload multipart/form-data ser salvo em disco, de modo que o nome e o caminho possam ser personalizados.

Sintaxe

property OnHTTPUploadBeforeSaveFile: TsgcWSHTTPUploadBeforeSaveFileEvent;
// TsgcWSHTTPUploadBeforeSaveFileEvent = procedure(Sender: TObject; var aFileName, aFilePath: string) of object

Valor Padrão

Observações

Quando HTTPUploadFiles.StreamType é pstFileStream e HTTPUploadFiles.RemoveBoundaries é True, o servidor extrai cada arquivo dos limites multipart/form-data recebidos e o salva em disco automaticamente. OnHTTPUploadBeforeSaveFile é gerado para cada arquivo logo antes de ser gravado, dando à aplicação a chance de substituir o destino: modifique aFileName (padrão é o nome de arquivo original do cliente) ou aFilePath (padrão é HTTPUploadFiles.SaveDirectory) para escolher um alvo diferente. Utilize-o para sanitizar nomes não confiáveis, rotear uploads para pastas por usuário ou prefixar um timestamp para evitar colisões.

Exemplo


procedure OnHTTPUploadBeforeSaveFileEvent(Sender: TObject; var aFileName: string;
  var aFilePath: string);
begin
  if aFileName = 'test.jpg' then
    aFileName := 'custom_test.jpg';
end;

Voltar para Eventos