OleFormat

OleFormat class

Permet d’accéder aux données d’un objet OLE ou d’un contrôle ActiveX.

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

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é (quandSourceFullName 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 null.
OleIcon { get; }Obtient l’aspect dessin de l’objet OLE. Quandvrai , l’objet OLE s’affiche sous forme d’icône. LorsqueFAUX , l’objet OLE s’affiche sous la forme content.
OlePackage { get; }Donner accès àOlePackage si l’objet OLE est un package OLE. nul 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 la saisie des 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 leOleFormatpropriété pour accéder aux données d’un objet OLE. Vous ne créez pas d’instances duOleFormat classe directement.

Exemples

Montre comment extraire des objets OLE incorporé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 sous un nom de fichier :
oleFormat.Save(ArtifactsDir + "OLE spreadsheet saved directly" + oleFormat.SuggestedExtension);

Voir également