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. يتم إرجاعهاباطل وإلا.
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);

أنظر أيضا

LayoutFlow Enum OlePackage Class