OleFormat

OleFormat class

Fournit l’accès aux données d’un objet OLE ou d’un contrôle ActiveX.

Pour en savoir plus, visitez leTravailler avec des objets Ole article de documentation.

public class OleFormat

Propriétés

NomLa description
AutoUpdate { get; set; }Spécifie si le lien vers l’objet OLE est automatiquement mis à jour ou non dans Microsoft Word.
Clsid { get; }Obtient le CLSID de l’objet OLE.
IconCaption { get; }Obtient la légende de l’icône de l’objet OLE.
IsLink { get; }Retoursvrai si l’objet OLE est lié (lorsqueSourceFullName est spécifié).
IsLocked { get; set; }Spécifie si le lien vers l’objet OLE est verrouillé contre les mises à jour.
OleControl { get; }ObtientOleControl objets si cet objet OLE est un contrôle ActiveX. Sinon, cette propriété est nulle.
OleIcon { get; }Obtient l’aspect de dessin de l’objet OLE. Lorsquevrai l’objet OLE s’affiche sous forme d’icône. LorsqueFAUX , l’objet OLE est affiché comme contenu.
OlePackage { get; }Fournir l’accès àOlePackage si l’objet OLE est un package OLE. Renvoienul sinon.
ProgId { get; set; }Obtient ou définit le ProgID de l’objet OLE.
SourceFullName { get; set; }Obtient ou définit le chemin et le nom du fichier source de l’objet OLE lié.
SourceItem { get; set; }Obtient ou définit une chaîne utilisée pour identifier la partie du fichier source qui est liée.
SuggestedExtension { get; }Obtient l’extension de fichier suggérée pour l’objet incorporé actuel si vous souhaitez l’enregistrer dans un fichier.
SuggestedFileName { get; }Obtient le nom de fichier suggéré pour l’objet incorporé actuel si vous souhaitez l’enregistrer dans un fichier.

Méthodes

NomLa description
GetOleEntry(string)Obtient l’entrée de données de l’objet OLE.
GetRawData()Obtient les données brutes de l’objet OLE.
Save(Stream)Enregistre les données de l’objet incorporé dans le flux spécifié.
Save(string)Enregistre les données de l’objet incorporé dans un fichier portant le nom spécifié.

Remarques

Utilisez leOleFormat propriété pour accéder aux données d’un objet OLE. Vous ne créez pas d’instances de laOleFormat classe directement.

Exemples

Montre comment extraire des objets OLE intégrés dans des fichiers.

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

// L'objet OLE dans la première forme est une feuille de calcul Microsoft Excel.
OleFormat oleFormat = shape.OleFormat;

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

// Notre objet n'est ni mis à jour automatiquement ni verrouillé contre les mises à jour.
Assert.False(oleFormat.AutoUpdate);
Assert.AreEqual(false, oleFormat.IsLocked);

// Si nous prévoyons d'enregistrer l'objet OLE dans un fichier du système de fichiers local,
// nous pouvons utiliser la propriété « SuggestedExtension » pour déterminer quelle extension de fichier appliquer au fichier.
Assert.AreEqual(".xlsx", oleFormat.SuggestedExtension);

// Vous trouverez ci-dessous deux manières d'enregistrer un objet OLE dans un fichier du système de fichiers local.
// 1 - Enregistrez-le via un flux :
using (FileStream fs = new FileStream(ArtifactsDir + "OLE spreadsheet extracted via stream" + oleFormat.SuggestedExtension, FileMode.Create))
{
    oleFormat.Save(fs);
}

// 2 - Enregistrez-le directement dans un nom de fichier :
oleFormat.Save(ArtifactsDir + "OLE spreadsheet saved directly" + oleFormat.SuggestedExtension);

Voir également