IFilePathProviderインターフェースを介してエクスポートされたワークシートのhtmlファイルパスを提供します。

可能な使用シナリオ

複数のシートを持つエクセルファイルがあるとし、各シートを個別のHTMLファイルにエクスポートしたいとします。いくつかのシートが他のシートへのリンクを持っている場合、そのリンクはエクスポートしたHTMLで壊れてしまいます。この問題に対処するために、Aspose.CellsはIFilePathProviderインターフェースを提供し、壊れたリンクを修正するために実装することができます。

IFilePathProviderインターフェースを介してエクスポートされたワークシートのHTMLファイルパスを提供する

以下のコードで使用されるサンプルエクセルファイルおよびそのエクスポートされたHTMLファイルをダウンロードしてください。これらのファイルはすべてTempディレクトリ内にあります。これをC:ドライブ上に解凍する必要があります。その後、C:\Tempディレクトリになります。その後、ブラウザでSheet1.htmlを開き、その中の2つのリンクをクリックしてください。これらのリンクは、C:\Temp\OtherSheetsディレクトリ内にある2つのエクスポートHTMLワークシートを参照しています。

 file:///C:/Temp/OtherSheets/Sheet2.html#RANGE!A1

file:///C:/Temp/OtherSheets/Sheet3.html#RANGE!A1

次のスクリーンショットは、C:\Temp\Sheet1.htmlおよびそのリンクの外観を示しています。

次のスクリーンショットはHTMLソースを示しています。リンクがC:\Temp\OtherSheetsディレクトリを参照していることがわかります。これはIFilePathProviderインターフェースを使用して達成されました。

サンプルコード

C:\Tempディレクトリはイラストレーション目的のみです。任意のディレクトリを使用し、提供されたサンプルコードを実行することができます。それから、提供されたサンプルコード内のdirPath変数を変更し、実行前に自分の選択したディレクトリを参照してください。

提供されたサンプルコードはAspose.Cellsライセンスを設定したときのみ動作します。ライセンスを設定せずにコードを実行しようとすると、無限ループに入ります。そのため、ライセンスが設定されていない場合にはメッセージを表示して実行を停止するチェックが追加されています。ライセンスを購入するか、Aspose.Purchaseチームから30日間の仮ライセンスをリクエストできます。

このコード内のコメントアウトされた行を見ると、Sheet1.htmlのリンクが壊れ、Sheet2.htmlまたはSheet3.htmlがSheet1.html内のリンクがクリックされても開かなくなります。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// If you will comment this line, then hyperlinks will be broken
options.FilePathProvider = new FilePathProvider();

提供されたサンプルエクセルファイルで実行できる完全なサンプルコードはこちらです。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
public class ExportedWorkSheetViaIFilePathProvider
{        
    // This is the directory path which contains the sample.xlsx file
    static string dirPath = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
    static void Main(string[] args)
    {
        // because Aspose.Cells will always make the warning worksheet as active sheet in Evaluation mode.
        SetLicense();

        // Check if license is set, otherwise do not proceed
        Workbook wb = new Workbook();
        if (wb.IsLicensed == false)
        {
            Console.WriteLine("You must set the license to execute this code successfully.");
            Console.ReadKey();
        }
        else
        {
            // Test IFilePathProvider interface
            TestFilePathProvider();
        }
    }

    static void SetLicense()
    {
        string licPath = @"Aspose.Cells.lic";

        Aspose.Cells.License lic = new Aspose.Cells.License();
        lic.SetLicense(licPath);

        Console.WriteLine(CellsHelper.GetVersion());
        System.Diagnostics.Debug.WriteLine(CellsHelper.GetVersion());

        Environment.CurrentDirectory = dirPath;
    }

    static void TestFilePathProvider()
    {
        // Create subdirectory for second and third worksheets
        Directory.CreateDirectory(dirPath + "OtherSheets");

        // Load sample workbook from your directory
        Workbook wb = new Workbook(dirPath + "Sample.xlsx");

        // Save worksheets to separate html files
        // Because of IFilePathProvider, hyperlinks will not be broken.
        for (int i = 0; i < wb.Worksheets.Count; i++)
        {
            // Set the active worksheet to current value of variable i
            wb.Worksheets.ActiveSheetIndex = i;

            // Creat html save option
            HtmlSaveOptions options = new HtmlSaveOptions();
            options.ExportActiveWorksheetOnly = true;
            // If you will comment this line, then hyperlinks will be broken
            options.FilePathProvider = new FilePathProvider();
            // Sheet actual index which starts from 1 not from 0
            int sheetIndex = i + 1;

            string filePath = "";

            // Save first sheet to same directory and second and third worksheets to subdirectory
            if (i == 0)
            {
                filePath = dirPath + "Sheet1.html";
            }
            else
            {
                filePath = dirPath + "OtherSheets\\Sheet" + sheetIndex + "_out.html";
            }

            // Save the worksheet to html file
            wb.Save(filePath, options);
        }
    }      
   
}
// Implementation of IFilePathProvider interface
public class FilePathProvider : IFilePathProvider
{
    // Constructor
    public FilePathProvider()
    {
    }

    // Gets the full path of the file by worksheet name when exporting worksheet to html separately.
    // So the references among the worksheets could be exported correctly.
    public string GetFullName(string sheetName)
    {
        if ("Sheet2".Equals(sheetName))
        {
            return @"file:///"  + "OtherSheets\\Sheet2.html";
        }
        else if ("Sheet3".Equals(sheetName))
        {
            return @"file:///"  + "OtherSheets\\Sheet3.html";
        }

        return "";
    }

}