Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

SetWriteinDB

oExcel:SetWriteinDB(lWriteinDb,[nLimit]) -> lEnabled

Configura o armazenamento auxiliar da geração XLSX.

SetWriteinDBAdvPL
01 · VISÃO GERAL

Visão geral

SetWriteinDB é método de FWMsExcelXlsx, não função global de gravação de tabelas de negócio. Requer LIB 20230227 ou superior, DBAccess 22.1.1.0 ou superior e ambiente preparado. Deve ser chamado antes de AddRow. O limite padrão de 200000 corresponde a registros/células auxiliares de bulk, não a linhas de planilha. A redução de memória tem custo de banco e desempenho; SQLite insere registro a registro. Verifique o lógico: .F. pode deixar o processamento no modo em memória. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

oExcel:SetWriteinDB(lWriteinDb,[nLimit]) -> lEnabled

Parâmetros

lWriteinDb
LógicoObrigatório

.T. habilita o recurso.

nLimit
NuméricoOpcional

Limite de células auxiliares por bulk; padrão 200000.

Retorno

Lógico: informa se habilitou o recurso.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed663(oExcel)
// Fragmento: oExcel e FWMsExcelXlsx, ambiente ja preparado.
Local lHabilitou
// Configurar antes de qualquer AddRow; conferir o fallback.
lHabilitou := oExcel:SetWriteinDB(.T.,200000)
If !lHabilitou
    ConOut("Dados auxiliares permanecerao em memoria")
EndIf
Return Nil
Resultado esperado

Solicita modo auxiliar no banco e sinaliza falha; não gera XLSX nem altera cadastros neste recorte. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Dimensionar memória e banco com volume real. Não presumir modo de banco sem verificar .T.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. FWMsExcelXlsx — SetWriteinDB. Requisitos e fallback. Consulta em 2026-10-28.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha