OleFormat

OleFormat class

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

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

public class OleFormat

Propiedades

NombreDescripción
AutoUpdate { get; set; }Especifica si el enlace 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; }Devolucionesverdadero si el objeto OLE está vinculado (cuandoSourceFullName se especifica).
IsLocked { get; set; }Especifica si el vínculo al objeto OLE está bloqueado para no recibir 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 content.
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 fuente para el objeto OLE vinculado.
SourceItem { get; set; }Obtiene o establece una cadena que se utiliza para identificar la parte del archivo fuente 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

Utilizar elOleFormatpropiedad para acceder a los datos de un objeto OLE. No crea instancias delOleFormat 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 de 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 recibir 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 secuencia:
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