OleFormat

OleFormat class

Proporciona acceso a los datos de un objeto OLE o un control ActiveX.

Para obtener más información, visite elTrabajar con objetos Ole Artículo de documentación.

public class OleFormat

Propiedades

NombreDescripción
AutoUpdate { get; set; }Especifica si el vínculo al objeto OLE se actualiza automáticamente o no en Microsoft Word.
Clsid { get; }Obtiene el CLSID del objeto OLE.
IconCaption { get; }Obtiene el título del icono del objeto OLE.
IsLink { get; }Devuelveverdadero si el objeto OLE está vinculado (cuandoSourceFullName se especifica).
IsLocked { get; set; }Especifica si el vínculo al objeto OLE está bloqueado para actualizaciones.
OleControl { get; }ObtieneOleControl Objetos si este objeto OLE es un control ActiveX. De lo contrario, esta propiedad es nula.
OleIcon { get; }Obtiene el aspecto de dibujo del objeto OLE. Cuandoverdadero el objeto OLE se muestra como un icono. CuandoFALSO , el objeto OLE se muestra como contenido.
OlePackage { get; }Proporcionar acceso aOlePackage si el objeto OLE es un paquete OLE. Devuelvenulo de lo contrario.
ProgId { get; set; }Obtiene o establece el ProgID del objeto OLE.
SourceFullName { get; set; }Obtiene o establece la ruta y el nombre del archivo de origen para el objeto OLE vinculado.
SourceItem { get; set; }Obtiene o establece una cadena que se utiliza para identificar la parte del archivo de origen que se está vinculando.
SuggestedExtension { get; }Obtiene la extensión de archivo sugerida para el objeto incrustado actual si desea guardarlo en un archivo.
SuggestedFileName { get; }Obtiene el nombre de archivo sugerido para el objeto incrustado actual si desea guardarlo en un archivo.

Métodos

NombreDescripción
GetOleEntry(string)Obtiene la entrada de datos del objeto OLE.
GetRawData()Obtiene datos sin procesar del objeto OLE.
Save(Stream)Guarda los datos del objeto incrustado en la secuencia especificada.
Save(string)Guarda los datos del objeto incrustado en un archivo con el nombre especificado.

Observaciones

Utilice elOleFormat propiedad para acceder a los datos de un objeto OLE. No crea instancias de laOleFormat clase directamente.

Ejemplos

Muestra cómo extraer objetos OLE incrustados en archivos.

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

//El objeto OLE en la primera forma es una hoja de cálculo de Microsoft Excel.
OleFormat oleFormat = shape.OleFormat;

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

//Nuestro objeto no se actualiza automáticamente ni está bloqueado para actualizaciones.
Assert.False(oleFormat.AutoUpdate);
Assert.AreEqual(false, oleFormat.IsLocked);

// Si planeamos guardar el objeto OLE en un archivo en el sistema de archivos local,
//Podemos usar la propiedad "SuggestedExtension" para determinar qué extensión de archivo aplicar al archivo.
Assert.AreEqual(".xlsx", oleFormat.SuggestedExtension);

A continuación se muestran dos formas de guardar un objeto OLE en un archivo en el sistema de archivos local.
// 1 - Guárdalo a través de una transmisión:
using (FileStream fs = new FileStream(ArtifactsDir + "OLE spreadsheet extracted via stream" + oleFormat.SuggestedExtension, FileMode.Create))
{
    oleFormat.Save(fs);
}

// 2 - Guárdalo directamente en un nombre de archivo:
oleFormat.Save(ArtifactsDir + "OLE spreadsheet saved directly" + oleFormat.SuggestedExtension);

Ver también

LayoutFlow Enum OlePackage Class