OLE オブジェクトを管理する

紹介

OLE (Object Linking and Embedding) は、Microsoft の複合ドキュメントテクノロジーのフレームワークです。簡単に言うと、複合ドキュメントとは、テキスト、カレンダー、アニメーション、音声、動画、3D、定期的に更新されるニュース、コントロールなど、あらゆる種類の視覚的および情報オブジェクトを含む表示デスクトップのことです。各デスクトップオブジェクトは、ユーザーと相互作用し、他のデスクトップ上の他のオブジェクトとも通信できる独立したプログラムエンティティです。

OLE (Object Linking and Embedding) は、さまざまなプログラムでサポートされており、あるプログラムで作成したコンテンツを別のプログラムで利用できるようにするために使用されます。たとえば、Microsoft Word ドキュメントを Microsoft Excel に挿入することができます。挿入可能なコンテンツの種類を確認するには、挿入 メニューで オブジェクト をクリックします。コンピュータにインストールされ、OLE オブジェクトをサポートするプログラムだけが オブジェクトの種類 ボックスに表示されます。

ワークシートにOLEオブジェクトを挿入する

Aspose.Cellsはワークシート内のOLEオブジェクトの追加、抽出、および操作をサポートしています。そのため、Aspose.Cellsには新しいOLEオブジェクトをコレクションリストに追加するために使用されるOleObjectCollectionクラスがあります。また、OleObjectという別のクラスはOLEオブジェクトを表します。いくつかの重要なメンバーがあります。

• ImageDataプロパティはバイト配列型の画像（アイコン）データを指定します。画像はOLEオブジェクトを示すために表示されます。
• ObjectDataプロパティはバイト配列形式のオブジェクトデータを指定します。このデータは、OLEオブジェクトアイコンをダブルクリックすると関連するプログラムに表示されます。

以下の例は、ワークシートにOLEオブジェクトを追加する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Instantiate a new Workbook.
Workbook workbook = new Workbook();

// Get the first worksheet.
Worksheet sheet = workbook.Worksheets[0];

// Define a string variable to store the image path.
string ImageUrl = dataDir + "logo.jpg";

// Get the picture into the streams.
FileStream fs = File.OpenRead(ImageUrl);

// Define a byte array.
byte[] imageData = new Byte[fs.Length];

// Obtain the picture into the array of bytes from streams.
fs.Read(imageData, 0, imageData.Length);

// Close the stream.
fs.Close();

// Get an excel file path in a variable.
string path = dataDir + "book1.xls";

// Get the file into the streams.
fs = File.OpenRead(path);

// Define an array of bytes.
byte[] objectData = new Byte[fs.Length];

// Store the file from streams.
fs.Read(objectData, 0, objectData.Length);

// Close the stream.
fs.Close();

// Add an Ole object into the worksheet with the image
// Shown in MS Excel.
sheet.OleObjects.Add(14, 3, 200, 220, imageData);

// Set embedded ole object data.
sheet.OleObjects[0].ObjectData = objectData;

// Save the excel file
workbook.Save(dataDir + "output.out.xls");

ワークブックからOLEオブジェクトを抽出

以下の例では、ワークブックからOLEオブジェクトを抽出する方法を示します。この例では既存のXLSファイルから異なるOLEオブジェクトを取得し、OLEオブジェクトのファイル形式に基づいて異なるファイル（DOC、XLS、PPT、PDFなど）を保存します。

コードを実行した後、対応するOLEオブジェクト形式の異なるファイルを保存できます。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the template file.
Workbook workbook = new Workbook(dataDir + "book1.xls");

// Get the OleObject Collection in the first worksheet.
Aspose.Cells.Drawing.OleObjectCollection oles = workbook.Worksheets[0].OleObjects;

// Loop through all the oleobjects and extract each object.
// In the worksheet.
for (int i = 0; i < oles.Count; i++)
{
    Aspose.Cells.Drawing.OleObject ole = oles[i];

    // Specify the output filename.
    string fileName = dataDir + "ole_" + i + ".";

    // Specify each file format based on the oleobject format type.
    switch (ole.FileFormatType)
    {
        case FileFormatType.Doc:
            fileName += "doc";
            break;
        case FileFormatType.Xlsx:
            fileName += "Xlsx";
            break;
        case FileFormatType.Ppt:
            fileName += "Ppt";
            break;
        case FileFormatType.Pdf:
            fileName += "Pdf";
            break;
        case FileFormatType.Unknown:
            fileName += "Jpg";
            break;
        default:
            //........
            break;
    }

    // Save the oleobject as a new excel file if the object type is xls.
    if (ole.FileFormatType == FileFormatType.Xlsx)
    {
        MemoryStream ms = new MemoryStream();
        ms.Write(ole.ObjectData, 0, ole.ObjectData.Length);
        Workbook oleBook = new Workbook(ms);
        oleBook.Settings.IsHidden = false;
        oleBook.Save(dataDir + "Excel_File" + i + ".out.xlsx");
    }

    // Create the files based on the oleobject format types.
    else
    {
        FileStream fs = File.Create(fileName);
        fs.Write(ole.ObjectData, 0, ole.ObjectData.Length);
        fs.Close();
    }
}

埋め込まれたMOLファイルの抽出

Aspose.Cellsは、MOL（原子および結合に関する情報を含む分子データファイル）のような一般的でないタイプのオブジェクトを抽出する機能をサポートしています。次のコードスニペットは、埋め込まれたMOLファイルを抽出してディスクに保存する方法を示しています: サンプルExcelファイルを使用します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
//directories
string SourceDir = RunExamples.Get_SourceDirectory();
string outputDir = RunExamples.Get_OutputDirectory();

Workbook workbook = new Workbook(SourceDir + "EmbeddedMolSample.xlsx");
var index = 1;
foreach (Worksheet sheet in workbook.Worksheets)
{
    OleObjectCollection oles = sheet.OleObjects;
    foreach (var ole in oles)
    {
        string fileName = outputDir + "OleObject" + index + ".mol ";
        FileStream fs = File.Create(fileName);
        fs.Write(ole.ObjectData, 0, ole.ObjectData.Length);
        fs.Close();
        index++;
    }
}

高度なトピック

• リンクされたオブジェクトの表示ラベルへのアクセスと変更
• Aspose.Cellsを使用してMicrosoft ExcelでOLEオブジェクトを自動的に更新する
• ワークブックからOLEオブジェクトを抽出
• 埋め込まれたOLEオブジェクトのクラス識別子を取得または設定する
• Ole ObjectとしてWAVファイルを挿入する