OleFormat

OleFormat class

يوفر الوصول إلى بيانات كائن OLE أو عنصر تحكم ActiveX.

لمعرفة المزيد، قم بزيارةالعمل مع كائنات Ole مقالة توثيقية.

public class OleFormat

الخصائص

اسموصف
AutoUpdate { get; set; }يحدد ما إذا كان الارتباط بكائن OLE سيتم تحديثه تلقائيًا أم لا في Microsoft Word.
Clsid { get; }الحصول على CLSID لكائن OLE.
IconCaption { get; }الحصول على تسمية توضيحية لكائن OLE.
IsLink { get; }إرجاعحقيقي إذا كان كائن OLE مرتبطًا (متىSourceFullName تم تحديده).
IsLocked { get; set; }يحدد ما إذا كان الارتباط بكائن OLE مؤمنًا من التحديثات.
OleControl { get; }يحصلOleControl الكائنات إذا كان كائن OLE هذا هو عنصر تحكم ActiveX. وإلا فإن هذه الخاصية فارغة.
OleIcon { get; }الحصول على مظهر الرسم لكائن OLE. متىحقيقي ، يتم عرض كائن OLE كرمز. متىخطأ شنيع ، يتم عرض كائن OLE كمحتوى.
OlePackage { get; }توفير الوصول إلىOlePackage إذا كان كائن OLE عبارة عن حزمة OLE. Returnsباطل وإلا.
ProgId { get; set; }الحصول على ProgID لكائن OLE أو تعيينه.
SourceFullName { get; set; }الحصول على أو تعيين مسار واسم الملف المصدر لكائن OLE المرتبط.
SourceItem { get; set; }الحصول على أو تعيين سلسلة يتم استخدامها لتحديد جزء الملف المصدر الذي يتم ربطه.
SuggestedExtension { get; }احصل على امتداد الملف المقترح للكائن المضمن الحالي إذا كنت تريد حفظه في ملف.
SuggestedFileName { get; }يحصل على اسم الملف المقترح للكائن المضمن الحالي إذا كنت تريد حفظه في ملف.

طُرق

اسموصف
GetOleEntry(string)يحصل على إدخال بيانات كائن OLE.
GetRawData()يحصل على البيانات الأولية لكائن OLE.
Save(Stream)يحفظ بيانات الكائن المضمن في الدفق المحدد.
Save(string)يحفظ بيانات الكائن المضمن في ملف بالاسم المحدد.

ملاحظات

استخدم الOleFormatالخاصية للوصول إلى بيانات كائن OLE. لا تقم بإنشاء مثيلات لـOleFormat الصف مباشرة.

أمثلة

يوضح كيفية استخراج كائنات OLE المضمنة في الملفات.

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

// كائن OLE الموجود في الشكل الأول هو جدول بيانات Microsoft Excel.
OleFormat oleFormat = shape.OleFormat;

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

// كائننا لا يتم تحديثه تلقائيًا ولا يتم قفله من التحديثات.
Assert.False(oleFormat.AutoUpdate);
Assert.AreEqual(false, oleFormat.IsLocked);

// إذا كنا نخطط لحفظ كائن OLE في ملف في نظام الملفات المحلي،
// يمكننا استخدام خاصية "SuggestedExtension" لتحديد امتداد الملف الذي سيتم تطبيقه على الملف.
Assert.AreEqual(".xlsx", oleFormat.SuggestedExtension);

// فيما يلي طريقتان لحفظ كائن OLE في ملف في نظام الملفات المحلي.
// 1 - احفظه عبر الدفق:
using (FileStream fs = new FileStream(ArtifactsDir + "OLE spreadsheet extracted via stream" + oleFormat.SuggestedExtension, FileMode.Create))
{
    oleFormat.Save(fs);
}

// 2 - احفظه مباشرة في اسم الملف:
oleFormat.Save(ArtifactsDir + "OLE spreadsheet saved directly" + oleFormat.SuggestedExtension);

أنظر أيضا