Управление внешними ресурсами с помощью WorkbookSetting.StreamProvider

Возможные сценарии использования

Иногда ваш файл Excel содержит внешние ресурсы, например связанные изображения и т. д. Aspose.Cells позволяет вам управлять этими внешними ресурсами с помощьюWorkbook.Settings.StreamProviderкоторый предполагает реализациюIStreamProviderинтерфейс. Всякий раз, когда вы пытаетесь отобразить свой рабочий лист, содержащий внешние ресурсы, например связанные изображения, методыIStreamProviderбудет вызван интерфейс, который позволит вам предпринять соответствующие действия для ваших внешних ресурсов.

Управление внешними ресурсами с помощью WorkbookSetting.StreamProvider

В следующем примере кода объясняется использованиеWorkbook.Settings.StreamProvider. Он загружаетобразец файла Excelсодержащий связанное изображение. Код заменяет связанное изображение наAspose Логотипи отображает весь лист в одно изображение, используяЛистрендерингучебный класс. На следующем снимке экрана показан пример файла Excel и еговизуализированное выходное изображениедля справки. Как видите, неработающее связанное изображение заменено логотипом Aspose.

Образец кода

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
//Implementation of IStreamProvider
class SP implements IStreamProvider
{
	public void closeStream(StreamProviderOptions arg0) throws Exception {
	}

	public void initStream(StreamProviderOptions options) throws Exception {

		//Open the filestream of Aspose Logo and assign it to StreamProviderOptions.Stream property
		File imgFile = new File(srcDir + "sampleControlExternalResourcesUsingWorkbookSetting_StreamProvider.png");

		byte[] bts = new byte[(int) imgFile.length()];

		FileInputStream fin = new FileInputStream(imgFile);
		fin.read(bts);
		fin.close();

		ByteArrayOutputStream baout = new ByteArrayOutputStream();
		baout.write(bts);
		baout.close();
		
		options.setStream(baout);
	}
}


public void Run() throws Exception {
	System.out.println("Aspose.Cells for Java Version: " + CellsHelper.getVersion());

	//String srcDir = Utils.Get_SourceDirectory();
	//String outDir = Utils.Get_OutputDirectory();

	//Load sample Excel file containing the external resource e.g. linked image etc.
	Workbook wb = new Workbook(srcDir + "sampleControlExternalResourcesUsingWorkbookSetting_StreamProvider.xlsx");

	//Provide your implementation of IStreamProvider
	wb.getSettings().setStreamProvider(new SP());

	//Access first worksheet
	Worksheet ws = wb.getWorksheets().get(0);

	//Specify image or print options, we need one page per sheet and png output
	ImageOrPrintOptions opts = new ImageOrPrintOptions();
	opts.setOnePagePerSheet(true);
	opts.setImageType(ImageType.PNG);

	//Create sheet render by passing required parameters
	SheetRender sr = new SheetRender(ws, opts);

	//Convert your entire worksheet into png image
	sr.toImage(0, outDir + "outputControlExternalResourcesUsingWorkbookSettingStreamProvider.png");

	// Print the message
	System.out.println("ControlExternalResourcesUsingWorkbookSetting_StreamProvider executed successfully.");
}

public static void main(String[] args) throws Exception {
	new ControlExternalResourcesUsingWorkbookSetting_StreamProvider().Run();
}