OleFormat

OleFormat class

Bietet Zugriff auf die Daten eines OLE-Objekts oder ActiveX-Steuerelements.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit OLE-Objekten Dokumentationsartikel.

public class OleFormat

Eigenschaften

NameBeschreibung
AutoUpdate { get; set; }Gibt an, ob die Verknüpfung zum OLE-Objekt in Microsoft Word automatisch aktualisiert wird oder nicht.
Clsid { get; }Ruft die CLSID des OLE-Objekts ab.
IconCaption { get; }Ruft die Symbolbeschriftung des OLE-Objekts ab.
IsLink { get; }RückgabenWAHR wenn das OLE-Objekt verknüpft ist (wennSourceFullName angegeben ist).
IsLocked { get; set; }Gibt an, ob die Verknüpfung zum OLE-Objekt vor Aktualisierungen gesperrt ist.
OleControl { get; }Ruft abOleControl Objekte, wenn dieses OLE-Objekt ein ActiveX-Steuerelement ist. Andernfalls ist diese Eigenschaft null.
OleIcon { get; }Ruft den Zeichenaspekt des OLE-Objekts ab. WennWAHRwird das OLE-Objekt als Symbol angezeigt. WennFALSCH , das OLE-Objekt wird als Inhalt angezeigt.
OlePackage { get; }Zugriff gewähren aufOlePackage wenn das OLE-Objekt ein OLE-Paket ist. Gibt zurücknull andernfalls.
ProgId { get; set; }Ruft die ProgID des OLE-Objekts ab oder legt sie fest.
SourceFullName { get; set; }Ruft den Pfad und den Namen der Quelldatei für das verknüpfte OLE-Objekt ab oder legt diese fest.
SourceItem { get; set; }Ruft eine Zeichenfolge ab oder legt sie fest, die zum Identifizieren des Teils der Quelldatei verwendet wird, der verknüpft wird.
SuggestedExtension { get; }Ruft die für das aktuelle eingebettete Objekt vorgeschlagene Dateierweiterung ab, wenn Sie es in einer Datei speichern möchten.
SuggestedFileName { get; }Ruft den für das aktuelle eingebettete Objekt vorgeschlagenen Dateinamen ab, wenn Sie es in einer Datei speichern möchten.

Methoden

NameBeschreibung
GetOleEntry(string)Ruft den Dateneintrag des OLE-Objekts ab.
GetRawData()Ruft Rohdaten des OLE-Objekts ab.
Save(Stream)Speichert die Daten des eingebetteten Objekts im angegebenen Stream.
Save(string)Speichert die Daten des eingebetteten Objekts in einer Datei mit dem angegebenen Namen.

Bemerkungen

Verwenden Sie dieOleFormat Eigenschaft, um auf die Daten eines OLE-Objekts zuzugreifen. Sie erstellen keine Instanzen derOleFormat Klasse direkt.

Beispiele

Zeigt, wie eingebettete OLE-Objekte in Dateien extrahiert werden.

Document doc = new Document(MyDir + "OLE spreadsheet.docm");
Shape shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

// Das OLE-Objekt in der ersten Form ist eine Microsoft Excel-Tabelle.
OleFormat oleFormat = shape.OleFormat;

Assert.AreEqual("Excel.Sheet.12", oleFormat.ProgId);

// Unser Objekt wird weder automatisch aktualisiert noch ist es für Aktualisierungen gesperrt.
Assert.False(oleFormat.AutoUpdate);
Assert.AreEqual(false, oleFormat.IsLocked);

// Wenn wir das OLE-Objekt in einer Datei im lokalen Dateisystem speichern möchten,
// Wir können die Eigenschaft „SuggestedExtension“ verwenden, um zu bestimmen, welche Dateierweiterung auf die Datei angewendet werden soll.
Assert.AreEqual(".xlsx", oleFormat.SuggestedExtension);

// Unten sind zwei Möglichkeiten zum Speichern eines OLE-Objekts in einer Datei im lokalen Dateisystem aufgeführt.
// 1 - Speichern Sie es über einen Stream:
using (FileStream fs = new FileStream(ArtifactsDir + "OLE spreadsheet extracted via stream" + oleFormat.SuggestedExtension, FileMode.Create))
{
    oleFormat.Save(fs);
}

// 2 - Speichern Sie es direkt unter einem Dateinamen:
oleFormat.Save(ArtifactsDir + "OLE spreadsheet saved directly" + oleFormat.SuggestedExtension);

Siehe auch