FieldCitation

FieldCitation class

ينفذ حقل CITATION.

لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.

public class FieldCitation : Field

المنشئون

اسموصف
FieldCitation()Default_Constructor

الخصائص

اسموصف
AnotherSourceTag { get; set; }الحصول على أو تعيين قيمة تطابقبطاقة شعار قيمة العنصر لمصدر آخر ليتم تضمينه في الاقتباس.
DisplayResult { get; }الحصول على النص الذي يمثل نتيجة الحقل المعروض.
End { get; }يحصل على العقدة التي تمثل نهاية الحقل.
Format { get; }يحصل علىFieldFormat الكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل.
FormatLanguageId { get; set; }الحصول على أو تعيين معرف اللغة المستخدم مع النمط الببليوغرافي المحدد لتنسيق الاقتباس في المستند.
IsDirty { get; set; }الحصول على أو تعيين ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب تعديلات أخرى تم إجراؤها على المستند.
IsLocked { get; set; }الحصول على أو تعيين ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب النتيجة).
LocaleId { get; set; }الحصول على أو تعيين LCID الخاص بالحقل.
PageNumber { get; set; }الحصول على أو تعيين رقم الصفحة المرتبطة بالاقتباس.
Prefix { get; set; }الحصول على أو تعيين بادئة مُلحقة بالاقتباس.
Result { get; set; }الحصول على أو تعيين النص الموجود بين فاصل الحقل ونهاية الحقل.
Separator { get; }يحصل على العقدة التي تمثل فاصل الحقول. يمكن ان يكونباطل .
SourceTag { get; set; }الحصول على أو تعيين قيمة تطابقبطاقة شعار قيمة العنصر للمصدر المراد إدراجه.
Start { get; }يحصل على العقدة التي تمثل بداية الحقل.
Suffix { get; set; }الحصول على أو تعيين اللاحقة الملحقة بالاقتباس.
SuppressAuthor { get; set; }الحصول على أو تحديد ما إذا كان سيتم حذف معلومات المؤلف من الاقتباس.
SuppressTitle { get; set; }الحصول على أو تحديد ما إذا كان سيتم حذف معلومات العنوان من الاقتباس.
SuppressYear { get; set; }الحصول على أو تحديد ما إذا كان سيتم حذف معلومات السنة من الاقتباس.
virtual Type { get; }الحصول على نوع حقل Microsoft Word.
VolumeNumber { get; set; }الحصول على أو تعيين رقم المجلد المرتبط بالاستشهاد.

طُرق

اسموصف
GetFieldCode()إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية.
GetFieldCode(bool)إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل).
Remove()إزالة الحقل من المستند. إرجاع عقدة مباشرة بعد الحقل. إذا كانت نهاية الحقل هي الطفل الأخير للعقدة الأصلية، فسيتم إرجاع الفقرة الأصلية الخاصة به. إذا تمت إزالة الحقل بالفعل، فسيتم إرجاعهباطل .
Unlink()يقوم بإلغاء ربط الحقل.
Update()يقوم بإجراء التحديث الميداني. يتم الرمي إذا تم تحديث الحقل بالفعل.
Update(bool)إجراء تحديث ميداني. يتم الرمي إذا تم تحديث الحقل بالفعل.

ملاحظات

يقوم بإدراج محتويات الملفمصدر عنصر مع المحددبطاقة شعار عنصر باستخدام النمط الببليوغرافي.

أمثلة

يوضح كيفية العمل مع حقول CITATION وBIBLIOGRAPHY.

// افتح مستندًا يحتوي على مصادر ببليوغرافية يمكننا العثور عليها
// Microsoft Word عبر المراجع -> اقتباسات & قائمة المراجع -> إدارة المصادر.
Document doc = new Document(MyDir + "Bibliography.docx");
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Text to be cited with one source.");

// أنشئ اقتباسًا باستخدام رقم الصفحة ومؤلف الكتاب المشار إليه فقط.
FieldCitation fieldCitation = (FieldCitation)builder.InsertField(FieldType.FieldCitation, true);

// نشير إلى المصادر باستخدام أسماء علاماتها.
fieldCitation.SourceTag = "Book1";
fieldCitation.PageNumber = "85";
fieldCitation.SuppressAuthor = false;
fieldCitation.SuppressTitle = true;
fieldCitation.SuppressYear = true;

Assert.AreEqual(" CITATION  Book1 \\p 85 \\t \\y", fieldCitation.GetFieldCode());

// قم بإنشاء اقتباس أكثر تفصيلاً يستشهد بمصدرين.
builder.InsertParagraph();
builder.Write("Text to be cited with two sources.");
fieldCitation = (FieldCitation)builder.InsertField(FieldType.FieldCitation, true);
fieldCitation.SourceTag = "Book1";
fieldCitation.AnotherSourceTag = "Book2";
fieldCitation.FormatLanguageId = "en-US";
fieldCitation.PageNumber = "19";
fieldCitation.Prefix = "Prefix ";
fieldCitation.Suffix = " Suffix";
fieldCitation.SuppressAuthor = false;
fieldCitation.SuppressTitle = false;
fieldCitation.SuppressYear = false;
fieldCitation.VolumeNumber = "VII";

Assert.AreEqual(" CITATION  Book1 \\m Book2 \\l en-US \\p 19 \\f \"Prefix \" \\s \" Suffix\" \\v VII", fieldCitation.GetFieldCode());

// يمكننا استخدام حقل الببليوغرافيا لعرض كافة المصادر داخل الوثيقة.
builder.InsertBreak(BreakType.PageBreak);
FieldBibliography fieldBibliography = (FieldBibliography)builder.InsertField(FieldType.FieldBibliography, true);
fieldBibliography.FormatLanguageId = "5129";

Assert.AreEqual(" BIBLIOGRAPHY  \\l 5129", fieldBibliography.GetFieldCode());

doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.CITATION.docx");

أنظر أيضا