Compartilhar via


Office.Slice interface

Representa uma fatia de um arquivo de documento. O objeto Setor é acedido com o File.getSliceAsync método .

Comentários

Exemplos

// This example demonstrates how to read file slices using the Office.Slice interface.
// Each slice represents a portion of the document file and includes the data, 
// index, and size properties.
Office.context.document.getFileAsync(Office.FileType.Compressed, { sliceSize: 65536 }, 
    function (result) {
        if (result.status === Office.AsyncResultStatus.Succeeded) {
            const file = result.value;
            const sliceCount = file.sliceCount;
            let slicesReceived = 0;
            let fileData = [];

            console.log(`File sliced into ${sliceCount} parts.`);

            // Get the first slice.
            getSliceAsync(file, 0, sliceCount);

            /**
             * Recursively retrieves slices from the file.
             * @param file - The Office.File object to retrieve slices from.
             * @param sliceIndex - The zero-based index of the slice to retrieve.
             * @param totalSlices - The total number of slices in the file.
             */
            function getSliceAsync(file, sliceIndex, totalSlices) {
                file.getSliceAsync(sliceIndex, function (sliceResult) {
                    if (sliceResult.status === Office.AsyncResultStatus.Succeeded) {
                        const slice: Office.Slice = sliceResult.value;
                        
                        // Access the properties of the Slice.
                        console.log(`Processing slice ${slice.index + 1} of ${totalSlices}`);
                        console.log(`Slice size: ${slice.size} bytes`);
                        
                        // Store the slice data.
                        fileData[slice.index] = slice.data;
                        slicesReceived++;

                        // Check if we've received all slices.
                        if (slicesReceived === totalSlices) {
                            file.closeAsync();
                            console.log("All slices received. File data complete.");
                            
                            // Process the complete file data.
                            processFileData(fileData);
                        } else {
                            // Get the next slice.
                            getSliceAsync(file, sliceIndex + 1, totalSlices);
                        }
                    } else {
                        file.closeAsync();
                        console.error(`Error getting slice: ${sliceResult.error.message}`);
                    }
                });
            }

            /**
             * Processes the complete file data by combining all slices.
             * @param data - An array of slice data arrays to combine.
             */
            function processFileData(data) {
                // Combine all slice data into a complete file.
                let combinedData = [];
                for (let i = 0; i < data.length; i++) {
                    combinedData.push(...data[i]);
                }
                
                console.log(`File processing complete. Total bytes: ${combinedData.length}`);
                // At this point, combinedData contains the complete file content.
                // You can now save it, send it to a server, or process it further.
            }
        } else {
            console.error(`Error getting file: ${result.error.message}`);
        }
    }
);

Propriedades

data

Obtém os dados não processados do setor de ficheiros no formato ou Office.FileType.Compressed conforme Office.FileType.Text especificado pelo fileType parâmetro da chamada para o Document.getFileAsync método .

index

Obtém o índice baseado em zero do setor de ficheiros.

size

Obtém o tamanho da fatia em bytes.

Detalhes da propriedade

data

Obtém os dados não processados do setor de ficheiros no formato ou Office.FileType.Compressed conforme Office.FileType.Text especificado pelo fileType parâmetro da chamada para o Document.getFileAsync método .

data: any;

Valor da propriedade

any

Comentários

Os ficheiros no formato "comprimido" devolverão uma matriz de bytes que pode ser transformada numa cadeia codificada em Base64, se necessário.

index

Obtém o índice baseado em zero do setor de ficheiros.

index: number;

Valor da propriedade

number

size

Obtém o tamanho da fatia em bytes.

size: number;

Valor da propriedade

number