Field

Field class

Bir Microsoft Word belge alanını temsil eder.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Alanlarla Çalışmak dokümantasyon makalesi.

public class Field

Özellikleri

İsimTanı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; }Bir alırFieldFormat Alanın formatlamasına 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 (sonucu yeniden hesaplanmamalı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. Olabilirhükümsüz .
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

İsimTanı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. Alanın hemen ardından bir düğüm döndürür. Alanın sonu, üst düğümünün son child ‘si ise, üst paragrafını döndürür. Alan zaten kaldırılmışsa şunu döndürür:hükümsüz .
Unlink()Alanın bağlantısını kaldırır.
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

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

Start ,Separator VeEnd özellikler sırasıyla the alanının 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 genellikle bir veya daha fazla öğesinden oluşurRun Talimatları belirten nesneler. İşleme uygulamasının, alan sonucunu hesaplamak için alan kodunu yürütmesi bekleniyor.

Saha sonuçlarının hesaplanması işlemine saha güncellemesi denir. Aspose.Words, çoğu alan türünün field sonuçlarını Microsoft Word’ün yaptığı gibi güncelleyebilir. En önemlisi, Aspose.Words en karmaşık formül alanlarının sonuçlarını bile hesaplayabilir. Tek bir alanın field sonucunu hesaplamak için şunu kullanın:Update yöntem. Tüm document kullanımındaki alanları güncellemek içinUpdateFields.

Alan kodunun düz metin versiyonunu aşağıdaki komutu 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 geçmiş 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çin şunu kullanın:InsertField yöntem.

Örnekler

Alan kodu kullanarak 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