Field

Field class

Bir Microsoft Word belge alanını temsil eder.

public class Field

Özellikleri

İsim Tanım
DisplayResult { get; } Görüntülenen alan sonucunu temsil eden metni alır.
End { get; } Alan sonunu temsil eden düğümü alır.
Format { get; } FieldFormat alanın biçimlendirmesine yazılı erişim sağlayan nesne.
IsDirty { get; set; } Belgede yapılan diğer değişiklikler nedeniyle alanın geçerli sonucunun artık doğru (eski) olup olmadığını alır veya ayarlar.
IsLocked { get; set; } Alanın kilitli olup olmadığını alır veya ayarlar (sonucunu yeniden hesaplamamalıdır).
LocaleId { get; set; } Alanın LCID’sini alır veya ayarlar.
Result { get; set; } Alan ayırıcı ile alan sonu arasındaki metni alır veya ayarlar.
Separator { get; } Alan ayırıcıyı temsil eden düğümü alır. null. olabilir
Start { get; } Alanın başlangıcını temsil eden düğümü alır.
virtual Type { get; } Microsoft Word alan türünü alır.

yöntemler

İsim Tanım
GetFieldCode() Alan başlangıcı ile alan ayırıcı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür. Alt alanların hem alan kodu hem de alan sonucu dahil edilir.
GetFieldCode(bool) Alan başlangıcı ile alan ayırıcı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür.
Remove() Alanı belgeden kaldırır. Alandan hemen sonra bir düğüm döndürür. Alanın sonu, üst düğümünün son çocuğu ise, üst paragrafını döndürür. Alan zaten kaldırılmışsa, döner hükümsüz .
Unlink() Bağlantıyı kaldır alanını gerçekleştirir.
Update() Alan güncellemesini gerçekleştirir. Alan zaten güncelleniyorsa atar.
Update(bool) Bir alan güncellemesi gerçekleştirir. Alan zaten güncelleniyorsa atar.

Notlar

Word belgesindeki bir alan, alan başlangıcı, alan kodu, alan ayırıcı, alan sonucu ve alan sonunu içeren birden çok düğümden oluşan karmaşık bir yapıdır. Alanlar iç içe yerleştirilebilir, zengin içerik ve bir belgede span birden çok paragraf veya bölüm içerebilir. buFieldclass, bir alanla tek bir nesne olarak çalışmaya izin veren özelliklerini ve yöntemlerini sağlayan bir “cephe” nesnesidir.

buStart ,Separator veEnd özellikler sırasıyla alanın the alanı başlangıç, ayırıcı ve bitiş düğümlerine işaret eder.

Alan başlangıcı ile ayırıcı arasındaki içerik alan kodudur. the alan ayırıcısı ile alan sonu arasındaki içerik, alan sonucudur. Alan kodu tipik olarak bir veya daha fazla ‘den oluşurRun yönergeleri belirten nesneler. İşleme uygulamasının, alan sonucunu hesaplamak için alan kodunu yürütmesi beklenir.

Alan sonuçlarını hesaplama işlemine alan güncelleme adı verilir. Aspose.Words, alan türlerinin çoğunun field sonuçlarını Microsoft Word’ün yaptığı gibi tam olarak güncelleyebilir. En önemlisi, Aspose.Words en karmaşık formül alanlarının bile sonuçlarını hesaplayabilir. Tek bir alanın field sonucunu hesaplamak içinUpdate yöntem. Tüm belgedeki alanları güncellemek için kullanınUpdateFields.

Alan kodunun düz metin sürümünü aşağıdakileri kullanarak alabilirsiniz:GetFieldCode method. Alan sonucunun düz metin versiyonunu aşağıdaki komutu kullanarak alabilir ve ayarlayabilirsiniz.Result property. Hem alan kodu hem de alan sonucu, iç içe alanlar, paragraflar, şekiller, tablolar gibi karmaşık içerik içerebilir ve bu durumda, daha fazla kontrole ihtiyacınız varsa, doğrudan alan düğümleriyle çalışmak isteyebilirsiniz.

Örneklerini oluşturmazsınızField doğrudan sınıf. Yeni bir alan oluşturmak içinInsertField yöntem.

Örnekler

Alan kodu kullanarak bir belgeye nasıl alan ekleneceğini gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Field field = builder.InsertField("DATE \\@ \"dddd, MMMM dd, yyyy\"");

Assert.AreEqual(FieldType.FieldDate, field.Type);
Assert.AreEqual("DATE \\@ \"dddd, MMMM dd, yyyy\"", field.GetFieldCode());

// InsertField yönteminin bu aşırı yüklemesi, eklenen alanları otomatik olarak günceller.
Assert.That(DateTime.Parse(field.Result), Is.EqualTo(DateTime.Today).Within(1).Days);

Ayrıca bakınız