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 der Link 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; }Gibt zurückWAHR ob das OLE-Objekt verknüpft ist (wannSourceFullName angegeben ist).
IsLocked { get; set; }Gibt an, ob der Link zum OLE-Objekt für 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. WannWAHR , das OLE-Objekt wird als Symbol angezeigt. WennFALSCH , das OLE-Objekt wird als content. angezeigt
OlePackage { get; }Zugriff gewähren aufOlePackage wenn das OLE-Objekt ein OLE-Paket ist. Gibt zurückNull sonst.
ProgId { get; set; }Ruft die ProgID des OLE-Objekts ab oder legt diese fest.
SourceFullName { get; set; }Ruft den Pfad und Namen der Quelldatei für das verknüpfte OLE-Objekt ab oder legt diesen fest.
SourceItem { get; set; }Ruft eine Zeichenfolge ab oder legt diese fest, die zur Identifizierung des Teils der Quelldatei verwendet wird, der verknüpft wird.
SuggestedExtension { get; }Ruft die für das aktuell eingebettete Objekt vorgeschlagene Dateierweiterung ab, wenn Sie es in einer Datei speichern möchten.
SuggestedFileName { get; }Ruft den für das aktuell eingebettete Objekt vorgeschlagenen Dateinamen ab, wenn Sie es in einer Datei speichern möchten.

Methoden

NameBeschreibung
GetOleEntry(string)Ruft den OLE-Objektdateneintrag ab.
GetRawData()Ruft OLE-Objekt-Rohdaten 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

Benutzen Sie dieOleFormatEigenschaft, um auf die Daten eines OLE-Objekts zuzugreifen. Sie erstellen keine Instanzen davonOleFormat 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 für Aktualisierungen gesperrt.
Assert.False(oleFormat.AutoUpdate);
Assert.AreEqual(false, oleFormat.IsLocked);

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

// Nachfolgend finden Sie zwei Möglichkeiten, ein OLE-Objekt in einer Datei im lokalen Dateisystem zu speichern.
// 1 - Über einen Stream speichern:
using (FileStream fs = new FileStream(ArtifactsDir + "OLE spreadsheet extracted via stream" + oleFormat.SuggestedExtension, FileMode.Create))
{
    oleFormat.Save(fs);
}

// 2 – Direkt unter einem Dateinamen speichern:
oleFormat.Save(ArtifactsDir + "OLE spreadsheet saved directly" + oleFormat.SuggestedExtension);

Siehe auch